localStorage e sessionStorage: Como Guardar Dados no Navegador com JavaScript

Aprenda a usar localStorage e sessionStorage no JavaScript: diferenças, métodos, como salvar objetos com JSON e cuidados de segurança.

Compartilhar no Linkedin Compartilhar no WhatsApp

Tempo estimado de leitura: 7 minutos

Imagem do artigo localStorage e sessionStorage: Como Guardar Dados no Navegador com JavaScript

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 / propriedadeO 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
lengthInforma 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ísticalocalStoragesessionStorageCookies
DuraçãoAté ser apagadoAté fechar a abaDefinida pela data de expiração
Enviado ao servidorNãoNãoSim, a cada requisição
Capacidade aproximadaAlguns megabytesAlguns megabytesCerca de 4 KB por cookie
Acesso via JavaScriptSimSimSim, exceto cookies HttpOnly
Uso típicoPreferências, rascunhos, cache leveDados temporários de uma sessãoSessõ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 HttpOnly e Secure para 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.

Cursos em vídeo

Cursos gratuitos em vídeo

Ver todos os cursos em vídeo

Cookies, Cache e Histórico: O Que o Navegador Guarda Sobre Você

Entenda o que são cookies, cache e histórico do navegador, para que servem, quando limpar cada um e como isso afeta sua privacidade.

Sensores e Atuadores: Como o Arduino Percebe o Mundo e Age Sobre Ele

Entenda a diferença entre sensores e atuadores, como o Arduino lê sinais e aciona dispositivos, e como montar seus primeiros projetos.

Endereço IP, Máscara de Sub-rede e Gateway: O Trio Que Faz Sua Rede Funcionar

Entenda de forma prática o que são endereço IP, máscara de sub-rede e gateway padrão, e como esses três parâmetros conversam entre si.

Compressão de Arquivos: Como o ZIP Consegue Reduzir o Tamanho dos Seus Dados

Entenda como funciona a compressão de arquivos, a diferença entre métodos com e sem perda e quando cada formato faz sentido.

Expressões Regulares (Regex): O Que São e Como Usar na Prática

Aprenda o que são expressões regulares, os principais símbolos, quantificadores e como aplicar regex para buscar e validar textos.

Como Funciona o DNS: o Sistema que Traduz Nomes em Endereços na Internet

Entenda de forma simples o que é DNS, como acontece a resolução de nomes, os principais tipos de registro e por que ele é essencial para a internet.

INNER JOIN, LEFT JOIN e RIGHT JOIN: como relacionar tabelas no SQL

Entenda de forma simples como funcionam INNER JOIN, LEFT JOIN, RIGHT JOIN e FULL JOIN para combinar dados de várias tabelas no SQL.

TypeScript para iniciantes: o que é e por que ele melhora o JavaScript

Entenda o que é TypeScript, como a tipagem estática ajuda a evitar erros e por que ele se tornou essencial no desenvolvimento web moderno.