Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é localStorage?

    O localStorage guarda pares de chave e valor no navegador, separados por origem. Permite recuperar preferências entre visitas, sujeito a políticas e limpeza.

    Também chamado de: armazenamento local do navegador

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    Preferências que permanecem entre visitas

    O localStorage é o armazenamento do navegador que guarda pares de chave e valor como texto para uma origem. A origem identifica o protocolo, o host e a porta da página. Os valores podem sobreviver ao fechamento do navegador, o que permite recuperar uma preferência na visita seguinte.

    Uma aplicação pode gravar o tema escolhido e consultá-lo ao carregar a página. Este exemplo didático usa os métodos de escrita e leitura:

    localStorage.setItem("tema", "escuro");
    const tema = localStorage.getItem("tema");

    A primeira linha grava o texto escuro sob a chave tema. A segunda recupera esse texto na variável tema. Uma chave ausente retorna null, então a aplicação precisa definir um tema inicial para essa situação.

    Ausência, falhas e acesso por scripts

    Você precisa tratar tanto a leitura quanto a escrita que falham. Políticas do navegador podem recusar o acesso e a gravação também pode exceder a capacidade disponível. Limpar o armazenamento remove as preferências. Na navegação privada, o conteúdo é descartado ao fechar a última aba privada.

    Scripts executados na mesma origem podem acessar esse armazenamento. Por isso, guardar uma preferência visual e guardar uma credencial têm consequências diferentes: o localStorage não oferece isolamento entre esses scripts.

    Dúvidas frequentes

    Perguntas frequentes sobre localStorage

    Páginas HTTP e HTTPS compartilham o mesmo localStorage?
    As duas usam áreas diferentes, mesmo com o mesmo domínio. A origem considera o protocolo, o nome do host e a porta.
    Como guardar um objeto JavaScript?
    Converta o objeto em texto com JSON.stringify e interprete o texto recuperado com JSON.parse. A leitura precisa tratar valores ausentes ou que não sejam JSON válido.
    O conteúdo acompanha você em outro dispositivo?
    A API não oferece sincronização entre dispositivos. Uma preferência gravada nesse navegador precisa de outro mecanismo para ficar disponível em outra máquina.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    Você pode conferir como a aplicação recupera preferências no navegador e qual tema exibe na ausência do valor gravado.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano