Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: DI-2169

Adicionar Item na Sessão do Navegador

Adiciona um valor item na sessão do navegador em uma chave temporária criada pelo usuário. 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 em vez de ser adicionado como um novo item.


Image Added

Figura 1 - Bloco Adicionar Item na Sessão do navegador

Compatibilidade

  • Bloco cliente: cronapi.util.setLocalStorage()

Retorno

Bloco sem retorno.

Parâmetros

NomeTipoDocParâmetro 1StringRecebe uma chave nomeada pelo usuário que irá armazenar o valorParâmetro 2StringRecebe o valor que será armazenado em uma chave

Compatibilidade

Image Removed Cliente

Exemplo

Chave

Chave do item que será armazenado ou atualizado.

  • 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: Texto / String
  • Exemplo: "Ana"

Exemplo

A função abaixo mostra um exemplo de uso do bloco Adicionar Item na Sessão do navegador. Ela irá armazenar, na sessão do navegador, o item representado pelo par chave/valor, "nome" e "Ana" respectivamente. Em seguida, O bloco Adicionar Item na Sessão do Navegador (Figura 1) recebe "nomeuser" no parâmetro Chave e no parâmetro Valor recebe "valorx", que será armazenado na chave. Após, a variável item recebe o bloco Obter Item da Sessão do Navegador para acessar navegador irá obter o valor armazenado na chave.  Por fim, imprime no console navegador o valor da variável "item" (Figura 2) obtido na sessão do navegador a partir de um evento ao clicar no botão.desse item através da sua chave e o imprimirá no console do navegador.


Image Added

Figura 2 - Exemplo de uso do bloco Image RemovedFigura 1 - Bloco Adicionar Item na Sessão do Navegador

Image RemovedFigura 2 - Retornando no console o item adicionado na sessão do navegador

Sobre Sessão do Navegador

Uma sessão consiste na utilização de uma aplicação por um usuário, compreendendo geralmente uma sequência de requisições.

O item adicionado na sessão do navegador é limpo ao fechar o navegador e é visível em qualquer aba.

navegador


A imagem a seguir exibe o resultado de execução da função da Figura 2.


Image Added

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