--- title: Window.localStorage slug: Web/API/Window/localStorage tags: - API - Armazenamento - Propriedade - Referencia - WindowLocalStorage - localStorage translation_of: Web/API/Window/localStorage original_slug: Web/API/Window/Window.localStorage ---

{{APIRef()}}

A propriedade localStorage permite acessar um objeto {{domxref("Storage")}} local. A localStorage é similar ao sessionStorage. A única diferença é que enquanto os dados armazenados no localStorage não expiram, os dados no sessionStorage tem os seus dados limpos ao expirar a sessão da página — ou seja, quando a página (aba ou janela) é fechada.

Sintaxe

meuStorage = localStorage;

Valor

Objeto {{domxref("Storage")}}.

Exemplo

O seguinte trecho acessa o objeto {{domxref("Storage")}} local do domínio atual e adiciona um item usando o {{domxref("Storage.setItem()")}}.

localStorage.setItem('meuGato', 'Tom');

Nota: Por favor veja o artigo Using the Web Storage API para um exemplo completo.

Especificações

Especificação Status Comentário
{{SpecName('Web Storage', '#dom-localstorage', 'localStorage')}} {{Spec2('Web Storage')}}  

{{ CompatibilityTable() }}

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 {{ CompatUnknown }} 8 11 iOS 3.2

Cada navegador tem o seu nível de capacidade de armazenamento para localStorage e {{domxref("sessionStorage")}}. Aqui está um teste detalhado de toda a capacidade de armazenamento de vários browsers.

Nota: desde o iOS 5.1, Safari Mobile armazena os dados do localStorage em uma pasta de cache, o que está sujeito a ocasionalmente ser limpa, de acordo com o SO, se houver pouco espaço. O modo de Navegação Privada do Safari Mobile não permite escrever no localStorage de forma alguma.

Veja também