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.