English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Método Storage setItem()

Objeto Storage do JavaScript

setItem()O método define o valor da chave especificada no objeto de armazenamento fornecido, se o valor da chave já existir, atualiza o valor da chave.

O método setItem() pertence ao objeto de armazenamento e pode serlocalStorageObjeto ousessionStorrageObjeto.

Sintaxe:

localStorage.setItem(key, value)
sessionStorage.setItem(key, value)
;localStorage.setItem('color' 'green');
;localStorage.setItem('image' 'parrot.png');
;localStorage.setItem('url' 'https://pt.oldtoolbag.com');
Teste e Veja‹/›

Compatibilidade do navegador

Os números na tabela especificam a primeira versão do navegador que suporta completamente o método setItem():

Método
setItem()43.511.549

Valor do parâmetro

ParâmetroDescrição
keyInclui o que você deseja criar/A string do nome da chave atualizada
valueInclui o que você deseja fornecer para criar/A string do valor da chave atualizada

Detalhes técnicos

Retorno:Uma string que representa o valor inserido
Versão DOM:API de armazenamento de rede

Mais exemplos

Definir o valor da item de armazenamento de sessão especificado:

sessionStorage.setItem('time' Date.now());
sessionStorage.setItem('age', 22);
Teste e Veja‹/›

Você ainda pode usar a notação de ponto para definir valores:

localStorage.color = "green";
localStorage.image = "parrot.png";
localStorage.url = "https://pt.oldtoolbag.com";
Teste e Veja‹/›

As seguintes funções criam três itens de dados no armazenamento local, e depois os utilizam para definir estilos personalizados na página:

function populateStorage() {
  ;localStorage.setItem('bgcolor', document.getElementById('bgcolor').value);
  ;localStorage.setItem('font', document.getElementById('font').value);
  ;localStorage.setItem('image', document.getElementById('image').value);
}
Teste e Veja‹/›

Referências Relacionadas

Tutoriais de HTML:API de Armazenamento Web

Referência: Janela (Window)Atributo window.localStorage

Referência: Janela (Window)Atributo window.sessionStorage

Objeto Storage do JavaScript