Criar Promessa

Cria uma promessa que futuramente irá receber um valor Cria um objeto de promessa com o status inicial "pending" (pendente). Após aguardar algum processamento, esse status pode ser alterado para "resolve" (resolvido) quando o fluxo atender as expectativas ou "reject" (rejeitado) quando não atender. O status do objeto é alterado com o uso do bloco Atribuir valor para a promessa.

Retorna

Retorna um objeto de promessa.

Compatibilidade

Image Removed Cliente

Exemplo

Image Added

Figura 1 - Bloco Criar Promessa

Compatibilidade

• Bloco cliente: cronapi.util.createPromise()

Retorno

Objeto de promessa com o status "pending" (pendente).

Parâmetros

Bloco sem parâmetros.

Exemplo 

Na função de exemplo da figura 2, a variável "promessa" é inicializada com o objeto da promessa ainda com o status de "pending"O exemplo da Figura 1 mostra o bloco Criar Promessa iniciando uma variável como promessa. Em seguida, o bloco Obter conteúdo da URL espera obter um serviço REST: caso consiga, o retorno de Sucesso será executado faz uma requisição REST e retorna algum valor. Se a requisição for bem-sucedida, a entrada de comando Sucesso é executada e o bloco Atribuir valor para a promessa irá alimentar a promessa com o conteúdo obtido, definindo seu tipo como altera o status da promessa para "resolve" ; caso não consiga obter o conteúdo REST, o retorno de Erro será executado e inclui o retorno da requisição como Valor dessa promessa. Caso ocorra algum erro durante a requisição, a entrada de comando Erro é executada e o bloco Atribuir valor para a promessa irá alimentar a promessa com o erro obtido, definindo seu tipo como altera o status da promessa para "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

Image Added

Figura 2 - Criação do objeto promessa 

Como estamos trabalhando com recursos assíncronos, o bloco Imprime com o texto "Fora da requisição." é executado antes da finalização do bloco Obter conteúdo da URL (figura 2.1).

Image Added

Figura 2.1 - Impressões geradas pela função a Figura 2

Saiba mais

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