Altera o status do objeto da promessa (criado a partir do bloco Criar Promessa) para "resolve" (resolvido) quando o fluxo atendeu as expectativas ou "reject" (rejeitado) quando não atendeu. 

Image Added

Figura 1 - Bloco Atribuir valor para a promessa

Parâmetros 

Compatibilidade

• Bloco cliente: cronapi.util.handleValueToPromise()

Retorno

Bloco sem retorno.

Parâmetros

Tipo

Define o status do objeto da promessa de "pending" (pendente) para uma das opções selecionadas.

• Posição: 1
• Inglês: Type
• Tipo: Texto / String
• Exemplo: "resolve"
• Opções:
  • resolve: altera o status para resolvido.
  • reject: altera o status para rejeitado.

Promessa

Recebe o objeto da promessa, criado a partir do bloco Criar Promessa.

• Posição: 2
• Inglês: Promise
• Tipo: Objeto / Object
• Exemplo: bloco Criar Promessa

Valor

Inclui no objeto o conteúdo de retorno da promessa. Utilize o bloco Monitorar uma promessa para obter esse valor dentro do objeto.

• Posição: 3
• Inglês: Value
• Tipo: Objeto / Object
• Exemplo: retorno de alguma requisição REST.

Exemplo

Na função da figura abaixo estamos criando e monitorando uma promessa até que a requisição REST seja concluída

Retorno

Retorna um valor para o sucesso ou erro se foi resolvido ou rejeitado.

Compatibilidade

Image Removed Cliente

Exemplo

O exemplo da Figura 1 mostra o bloco Criar Promessa iniciando uma variável como promessa. Em seguida, obloco Obter conteúdo da URL espera obter um serviço REST: caso consiga, o retorno de Sucesso será executado e o bloco Atribuir valor para a promessa irá alimentar a promessa com o conteúdo obtido, definindo seu tipo como "resolve"; caso não consiga obter o conteúdo REST, o retorno de Erro será executado e o bloco Atribuir valor para a promessa irá alimentar a promessa com o erro obtido, definindo seu tipo como "reject".

Ao final, a função Blocos de promessa retorna a promessa resolvida ou rejeitada. Veja um exemplo de uso aqui.

Image RemovedFigura 1 - Como é utilizado o bloco Atribuir valor para a promessa

altere o status da promessa de "pending" para "resolve" ou "reject".

Image Added

Figura 2 - Exemplo de uso do bloco Atribuir valor para a promessa

1. A variável "promessa" recebe o objeto da promessa criado a partir do bloco Criar Promessa.  Nesse momento o objeto da promessa está com o status definido como "pending" (pendente).
2. O bloco Monitorar uma Promessa ficará "ouvindo" a promessa até que ela mude seu status. O conteúdo da entrada de comando Sucesso será executado quando o status da promessa mudar para "resolve", caso mude para "reject", será executado a entrada de comando Erro. 
3. É feito uma requisição REST que executará uma das entradas de comando com base no sucesso ou erro dessa requisição.
   1. Sucesso: o bloco Atribuir valor para a promessa define no parâmetro Tipo que a promessa foi resolvida e no parâmetro Valor informa o retorno da requisição REST.
   2. Erro: o bloco Atribuir valor para a promessa define no parâmetro Tipo que a promessa foi rejeitada e no parâmetro Valor informa uma mensagem de erro.

Ao executar a função da figura 2 com uma requisição REST bem sucedida, o bloco Atribuir valor para a promessa definirá o status da promessa para "resolve". Em seguida, o bloco Monitorar uma promessa (destaque 2 da figura 2) imprimirá no console do navegador o texto com o retorno da requisição (figura 2.1). 

Image Added

Figura 2.1 - Resultado com sucesso da execução da função da figura 2

Caso ocorra uma falha na requisição REST, o bloco Atribuir valor para a promessa definirá o status da promessa para "reject". Em seguida, o bloco Monitorar uma promessa (destaque 2 da figura 2) imprimirá no console do navegador (1 da figura 2.2) o texto informado no parâmetro Valor (destaque b da figura 2).

Image Added

Figura 2.2 - Resultado com falha da execução da função da figura 2

Saiba mais

Veja detalhes sobre o conceito de Promessas no JavaScript em Promise.