Armazenamento de dados no cordova com local storage

Se você está iniciando no mundo da programação de aplicativos usando o Apache Cordova, e precisa armazenar dados de configurações ou dados de usuários, veja nesse tutorial uma forma simples e rápida de realizar esse procedimento.

Caso você precise armazenar muitos dados, os quais ultrapassam 5MB, então recomendo fazer uso de banco de dados. Nesse tutorial vamos estar utilizando o espaço de armazenamento disponibilizado pelo browser (ou webview no android). Esse método de armazenamento de dados tem um tamanho limitado a 5MB.

Salvando dados

Para armazenar uma informação ou um array de informações basta usar o método setItem e informar o nome da chave.

window.localStorage.setItem('NOME', 'Maria');
window.localStorage.setItem('SEXO', 'Feminino');

Salvando uma lista de dados.

var pessoas = {}; //lista de pessoas

var pessoa = {};
pessoa.nome = "Maria";
pessoa.sexo = "Feminino";
pessoas.push({...pessoa});

var pessoa = {};
pessoa.nome = "João";
pessoa.sexo = "Masculino";
pessoas.push({...pessoa});

//armazenando de forma persistente
window.localStorage.setItem('PESSOAS', JSON.stringify(pessoas));

Recuperando dados

Para obter os dados salvos com setItem devemos usar o método getItem e informar o nome da chave. O método retorna null caso não tenha nada salvo com a chave informada.

var nome = window.localStorage.getItem('NOME');
var sexo = window.localStorage.setItem('SEXO');

Recuperando uma lista de dados.

var pessoas = window.localStorage.getItem('PESSOAS');

//verificar se já existem dados salvos
if (pessoas != null) {
    pessoas = JSON.parse(pessoas);
    for (var i = 0; i < pessoas.length; i++) {
        var pessoa = pessoas[i];
        console.log('nome: '+pessoa.nome+' sexo: '+pessoa.sexo);
    }
}

Deletando dados

Se for preciso remover os dados juntamente com a chave é só usar ó método removeItem.

window.localStorage.removeItem('NOME');
window.localStorage.removeItem('SEXO');
window.localStorage.removeItem('PESSOAS');

Você pode preferir zerar os dados ao invés de remover a variável de armazenamento.

window.localStorage.setItem('NOME', null);
window.localStorage.setItem('SEXO', null);
window.localStorage.setItem('PESSOAS', "[]");

É possível desenvolver vários tipos de aplicativos usando apenas localStorage para armazenamento de dados. Outra grande utilidade desse tipo de armazenamento persistente é o uso para salvar configurações do aplicativo definidas pelo usuário. Em qualquer parte do app é possível recuperar rapidamente as preferências do usuário sem necessidade de conexão com banco de dados.