Esta tradução está incompleta. Ajude atraduzir este artigo.
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
- keyName
- Um
DOMStringcontendo o nome da chave que você deseja criar ou alterar. - keyValue
- Um
DOMStringcontendo o valor da chave que você está criando ou atualizando.
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 |
|---|---|---|
| Web Storage (Second edition) The definition of 'setItem()' in that specification. |
Recommendation |
Navegadores compatíveis
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| localStorage | 4 | 3.5 | 8 | 10.50 | 4 |
| sessionStorage | 5 | 2 | 8 | 10.50 | 4 |
| Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Basic support | 2.1 | ? | 8 | 11 | iOS 3.2 |
Todos os navegadores têm diferentes níveis de capacidade para tanto localStorage e sessionStorage. Aqui você encontra uma detalhada a capacidade detalhada para vários browsers.
Nota: desde a versão iOS 5.1, Mobile Safari os dados na pasta 'cache' estão sujeito a limpezas ocasionais devido ao pouco espaço disponível.