API de Armazenamento Web

A API Web Storage é uma sintaxe simples para armazenar e recuperar dados no navegador. Ela é muito fácil de usar:

Instância

localStorage.setItem("name", "Bill Gates");
localStorage.getItem("name");

Experimente você mesmo

Todos os navegadores suportam a API Web Storage:

Chrome IE Firefox Safari Opera
Chrome IE/Edge Firefox Safari Opera
Suporte Suporte Suporte Suporte Suporte

Objeto localStorage

O objeto localStorage fornece acesso ao armazenamento local de um site específico. Ele permite que você armazene, leia, adicione, modifique e exclua itens de dados para esse domínio.

Os dados armazenados não têm data de expiração e não são deletados quando o navegador for fechado.

Esses dados estarão disponíveis por dias, semanas e anos.

Método setItem()

O método localStorage.setItem() armazena itens de dados no storage.

Ele aceita um nome e um valor como parâmetros:

Instância

localStorage.setItem("name", "Bill Gates");

Método getItem()

O método localStorage.getItem() recupera itens de armazenamento (storage).

Ele aceita um nome como parâmetro:

Instância

localStorage.getItem("name");

Objeto sessionStorage

O objeto sessionStorage é o mesmo que o objeto localStorage.

A diferença está no objeto sessionStorage que armazena dados de sessão.

Os dados serão deletados quando o navegador for fechado.

Instância

sessionStorage.getItem("name");

Experimente você mesmo

Método setItem()

O método sessionStorage.setItem() armazena itens de dados no armazenamento (storage).

Ele aceita um nome e um valor como parâmetros:

Instância

sessionStorage.setItem("name", "Bill Gates");

Método getItem()

O método sessionStorage.getItem() recupera itens de armazenamento (storage).

Ele aceita um nome como parâmetro:

Instância

sessionStorage.getItem("name");

Atributos e métodos do objeto Storage

Atributo/Método Descrição
key(n) Retorna o nome da chave armazenada na posição n.
length Retorna o número de itens armazenados no objeto Storage.
getItem(keyname) Retorna o valor da chave especificada.
setItem(keyname, value) Adiciona a chave ao armazenamento, ou atualiza o valor da chave se já existir.
removeItem(keyname) Remove a chave do armazenamento.
clear() Limpa todas as chaves.

Páginas relacionadas ao Web Storage API

Propriedade Descrição
window.localStorage Permite salvar pares de chave/valor no navegador da Web. Armazena dados sem data de expiração.
window.sessionStorage Permite salvar pares de chave/valor no navegador da Web. Armazena dados de uma sessão.