Armazena um item no armazenamento local. Esse item é do tipo chave/valor, ou seja, contém um valor associado a uma chave.

Caso a chave atribuída a um item já esteja associada a outro item armazenado, o valor deste será atualizado na chave existente ao invés de ser adicionado como um novo item.

Figura 1 - Bloco Adicionar item de armazenamento

Compatibilidade

• Bloco cliente mobile: cronapi.cordova.storage.setStorageItem()

Retorno

Bloco sem retorno.

Parâmetros

Chave

Chave do item que será armazenado.

• Posição: 1
• Inglês: Key
• Tipo: Texto / String
• Exemplo: "nome"

Valor

Conteúdo a ser armazenado no valor do item.

• Posição: 2
• Inglês: Value
• Tipo: Objeto / Object
• Exemplo: "Ana"

Exemplo

A função abaixo mostra um exemplo de uso do bloco Adicionar item de armazenamento. Ela utiliza o mecanismo de armazenamento local dos navegadores para armazenar o item representado pelo par chave/valor, "nome" e "Ana" respectivamente. Em seguida, na variável "item", por meio do bloco Obter Item de armazenamento, obtemos o valor do item e o apresentamos na tela através do bloco Exibir Notificação.

Figura 2 - Exemplo de uso do bloco Adicionar item de armazenamento

A imagem a seguir mostra o resultado de execução da função da Figura 2. Após clicar no botão "Adicionar item de armazenamento", a função é executada e uma mensagem de notificação é exibida com o valor do item adicionado.

Figura 2.1 - Resultado de execução da função da Figura 2

Saiba mais

O armazenamento local ou Local Storage é um objeto JavaScript que é utilizado para armazenar dados no navegador do cliente. Os pares de chave e valor gravados no armazenamento local não podem ser acessados por outros subdomínios, fazendo com que o risco de acesso a informação por entidades não autorizadas seja reduzido. O local Storage ainda mantém o dado gravado até que este seja removido diretamente, possibilitando que o navegador seja fechado ou até mesmo o computador reiniciado sem que haja perda de dados.