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
Documentação
MDN: valores locais associados à origem
Descreve a separação por origem, a duração do armazenamento e as falhas de acesso previstas no navegador.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Orientação ao vivo para revisar a gravação de preferências e o comportamento da aplicação quando o armazenamento está indisponível.
Abrir recursoAplicaçã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
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.