Storage.setItem()
O método setItem()
da interface Storage
, quando passado 'chave' e 'valor', irá adicionar esta chave ao storage, ou atualizar o valor caso a chave já exista.
Syntax
storage.setItem(keyName, keyValue);
Parâmetros
Retornos
Sem retorno.
Exceções
setItem()
poderá lançar uma exceção caso o storage esteja cheio. Particularmente, no Safari Mobile (desde o iOS 5) sempre irá lançar quando o usuário entrar em modo privado (Safari define a quota para 0 bytes no modo privado ao contrário de outros navegadores que permitem o armazenamento em modo privado, usando recipientes de dados separados).
Assim os desenvolvedores devem certificar-se de sempre tratar as possíveis exceções do setItem()
.
Exemplo
A função abaixo irá criar três dados dentro do local storage.
function populateStorage() {
localStorage.setItem('bgcolor', 'red');
localStorage.setItem('font', 'Helvetica');
localStorage.setItem('image', 'myCat.png');
}
Nota: Para ver ele sendo usado em um exemplo real, consulte nosso Web Storage Demo.
Especificações
Specification | Status | Comment |
---|---|---|
Unknown The definition of 'setItem()' in that specification. |
Desconhecido |
Navegadores compatíveis
BCD tables only load in the browser