Você já percebeu que alguns sites lembram o tema escuro que você escolheu, os itens de um formulário que ainda não foi enviado ou o conteúdo de um carrinho, mesmo depois de recarregar a página? Muitas vezes isso é feito com a Web Storage API, que oferece dois recursos simples e muito úteis no front-end: o localStorage e o sessionStorage. Neste artigo, você vai entender o que cada um faz, como usá-los no JavaScript e quando é melhor escolher outra solução.
O que é a Web Storage API?
A Web Storage API é um recurso dos navegadores que permite armazenar dados no formato chave e valor diretamente no computador do usuário. Esses dados ficam vinculados à origem do site, ou seja, à combinação de protocolo, domínio e porta. Um site não consegue ler o que outro site guardou.
Ela oferece dois objetos com a mesma interface de métodos:
- localStorage: os dados permanecem salvos mesmo depois que o navegador é fechado. Só desaparecem se forem removidos pelo código, pelo usuário (limpando os dados do site) ou pelo próprio navegador.
- sessionStorage: os dados duram apenas enquanto a aba estiver aberta. Ao fechar a aba, eles são apagados. Cada aba tem seu próprio sessionStorage, mesmo que seja do mesmo site.
Os principais métodos
Tanto o localStorage quanto o sessionStorage usam os mesmos métodos. Veja os mais importantes:
| Método / propriedade | O que faz |
|---|---|
setItem(chave, valor) | Salva um valor associado a uma chave |
getItem(chave) | Retorna o valor salvo ou null se a chave não existir |
removeItem(chave) | Remove apenas a chave indicada |
clear() | Apaga todos os dados daquela origem |
key(índice) | Retorna o nome da chave em determinada posição |
length | Informa quantos itens estão armazenados |
Um exemplo básico de uso:
// Salvando
localStorage.setItem('tema', 'escuro');
// Lendo
const tema = localStorage.getItem('tema'); // "escuro"
// Removendo
localStorage.removeItem('tema');
Atenção: tudo é salvo como texto
Um detalhe que pega muitos iniciantes de surpresa: a Web Storage só armazena strings. Se você salvar o número 10, vai receber de volta o texto "10". Se tentar salvar um objeto diretamente, o resultado será a string "[object Object]", e os dados se perdem.
A solução é converter objetos e arrays para JSON antes de salvar e fazer o caminho inverso ao ler:
const usuario = { nome: 'Ana', idade: 28 };
// Objeto → texto JSON
localStorage.setItem('usuario', JSON.stringify(usuario));
// Texto JSON → objeto
const salvo = JSON.parse(localStorage.getItem('usuario'));
console.log(salvo.nome); // "Ana"
Como getItem retorna null quando a chave não existe, é uma boa prática prever um valor padrão:
const tarefas = JSON.parse(localStorage.getItem('tarefas')) || [];
Exemplo prático: lembrando o tema escolhido
Imagine um botão que alterna entre tema claro e escuro. Com poucas linhas, dá para fazer o site lembrar a preferência do visitante:
const botao = document.querySelector('#alternar-tema');
// Aplica o tema salvo ao carregar a página
const temaSalvo = localStorage.getItem('tema') || 'claro';
document.body.classList.add(temaSalvo);
botao.addEventListener('click', () => {
const novoTema = document.body.classList.contains('escuro') ? 'claro' : 'escuro';
document.body.classList.remove('claro', 'escuro');
document.body.classList.add(novoTema);
localStorage.setItem('tema', novoTema);
});
Já o sessionStorage é ideal para dados temporários, como as etapas preenchidas de um formulário longo. Se o usuário recarregar a página por engano, as informações continuam lá; ao fechar a aba, somem.
localStorage, sessionStorage e cookies: quando usar cada um
Os cookies também guardam dados no navegador, mas funcionam de forma diferente. A principal distinção é que os cookies são enviados automaticamente ao servidor a cada requisição, enquanto a Web Storage fica apenas no lado do cliente.
| Característica | localStorage | sessionStorage | Cookies |
|---|---|---|---|
| Duração | Até ser apagado | Até fechar a aba | Definida pela data de expiração |
| Enviado ao servidor | Não | Não | Sim, a cada requisição |
| Capacidade aproximada | Alguns megabytes | Alguns megabytes | Cerca de 4 KB por cookie |
| Acesso via JavaScript | Sim | Sim | Sim, exceto cookies HttpOnly |
| Uso típico | Preferências, rascunhos, cache leve | Dados temporários de uma sessão | Sessões de login, informações que o servidor precisa ler |
O limite exato de espaço da Web Storage varia de navegador para navegador, mas costuma ficar na casa de poucos megabytes por origem. Se o limite for ultrapassado, o setItem lança um erro, que pode ser tratado com try...catch.
Cuidados de segurança
A facilidade da Web Storage tem um preço: qualquer script que rode na página consegue ler o que está salvo. Se o site sofrer um ataque de XSS (injeção de scripts maliciosos), esses dados podem ser roubados. Por isso:
- Não guarde senhas, dados de cartão ou informações pessoais sensíveis.
- Evite armazenar tokens de autenticação sem avaliar os riscos; muitas aplicações preferem cookies com as flags
HttpOnlyeSecurepara isso. - Lembre que o usuário pode ver e editar esses dados nas ferramentas do desenvolvedor (aba Application ou Armazenamento). Nunca confie neles para regras de negócio importantes.
- Valide o conteúdo lido antes de usá-lo, já que ele pode ter sido alterado.
Sincronizando abas com o evento storage
Um recurso pouco conhecido é o evento storage. Quando o localStorage é alterado em uma aba, as outras abas abertas do mesmo site recebem esse evento. Isso permite, por exemplo, atualizar o tema em todas as abas ao mesmo tempo:
window.addEventListener('storage', (evento) => {
if (evento.key === 'tema') {
document.body.className = evento.newValue;
}
});
Conclusão
O localStorage e o sessionStorage são ferramentas simples para melhorar a experiência do usuário: lembram preferências, preservam rascunhos e evitam requisições desnecessárias. O segredo é usá-los para dados não sensíveis, sempre convertendo objetos com JSON e tratando a ausência de valores. Para informações críticas, como autenticação, avalie alternativas mais seguras.
Se você quer se aprofundar em JavaScript e no desenvolvimento de interfaces, confira os cursos gratuitos de Programação Front-End disponíveis na Cursa e pratique esses conceitos em projetos reais.







