Storage.length

Esta tradução está incompleta. Ajude atraduzir este artigo.

A propriedade length, que é somente leitura, da interface Storage retorna um inteiro que representa o número de itens armazenados no objeto Storage.

Sintaxe

var aLength = storage.length;

Retorno

Um inteiro

Exemplo

A função a seguir adiciona três itens ('bgcolor', 'font' e 'image') ao local storage do domínio atual, em seguida retorna o número de itens no storage:

function populateStorage() {
  localStorage.setItem('bgcolor', 'yellow');
  localStorage.setItem('font', 'Helvetica');
  localStorage.setItem('image', 'cats.png');

  localStorage.length; // should return 3
}

Nota: Para um exemplo do mundo real, veja nosso Web Storage Demo.

Especificações

Especificação Status Comentário
Web Storage (Second edition)
The definition of 'length' in that specification.
Recommendation  

Compatibilidade com browsers

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
localStorage 4 (Yes) 3.5 8 10.50 4
sessionStorage 5 ? 2 8 10.50 4
Feature Android Edge Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 2.1 (Yes) ? 8 11 iOS 3.2

Cada browser tem uma capacidade variada para localStorage e sessionStorage. Aqui existe um tabela detalhada sobre a capacidade de armazenamento de cada browser.

Nota: desde o iOS 5.1, o Safari Mobile armazena os dados do localStorage no folder de cache, que está sujeito a uma limpeza ocasional baseada em regras do SO, tipicamente, quando o espaço está se esgotando.

Veja também

Usando a API Web Storage

Etiquetas do documento e colaboradores

 Colaboradores desta página: bfabbri
 Última atualização por: bfabbri,