Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

localStorage — armazenamento local de dados

localStorage disponibiliza ao navegador um armazenamento de pares chave-valor em texto, associado a uma origem. Os dados podem persistir para além de uma sessão, mas o acesso e a persistência dependem das políticas do navegador.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

window.localStorage
localStorage.setItem(key, value)
localStorage.getItem(key)
localStorage.removeItem(key)

window.localStorage devolve um objeto Storage para a origem da página. É uma API Web definida pelo HTML Living Standard, não uma funcionalidade ECMAScript. Os motores de navegador atuais suportam-na; o Node 24 no repositório não comprova o suporte nos navegadores.

setItem(key, value) armazena texto, getItem(key) devolve texto ou null e removeItem(key) elimina uma entrada. clear() elimina todas as entradas nessa área de armazenamento, não apenas as da aplicação.

Ao contrário de sessionStorage, os dados podem persistir para além de uma sessão e ser partilhados entre janelas da mesma origem. Não é uma cópia de segurança: o utilizador ou o navegador podem eliminá-los. Não pressuponha que existe um bloqueio para operações de leitura–alteração–escrita. As alterações acionam um evento storage noutras janelas que utilizem essa área de armazenamento, mas não na janela que escreve.

O próprio acesso pode gerar SecurityError e a escrita pode gerar QuotaExceededError; trate ambos. Os scripts da mesma origem podem ler os dados, por isso não armazene segredos aqui. Se as operações forem bem-sucedidas, o exemplo escreve um valor associado a uma chave gerada aleatoriamente, lê esse valor e elimina a entrada sem repor qualquer valor anterior. Na execução apresentada, o acesso a window.localStorage gera um erro SecurityError antes de o código chegar à escrita.

Exemplos

(() => {
  const key = `cktis-storage-${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
  try {
    const storage = window.localStorage;
    storage.setItem(key, 42);
    let stored;
    try {
      stored = storage.getItem(key);
    } finally {
      storage.removeItem(key);
    }
    console.log(`Stored as a string: ${stored === '42'}`);
    console.log(`Missing after removal: ${storage.getItem(key) === null}`);
  } catch (error) {
    console.log(`Storage unavailable: ${error.name}`);
  }
})();

Resultado

Storage unavailable: SecurityError

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes