Código JavaScript

Executa um bloco de código JavaScript personalizado dentro do fluxo de automação e retorna o valor produzido. Ideal para operações que não possuem uma ação dedicada — como cálculos complexos, transformações de dados, formatações específicas ou manipulações avançadas de objetos e listas.

Dica

Use return no seu código para definir o valor que será retornado pela ação e disponível para as próximas etapas do fluxo.

Opções

Código

Escreva o bloco de código JavaScript que será executado. Use return para definir o valor de retorno.

Acessando saídas de ações anteriores

O objeto actions está disponível dentro do código e contém os retornos de todas as ações que vieram antes no fluxo. Use o ID ou o alias da ação para acessar seus campos:

// Sintaxe: actions["id_ou_alias"]["campo"]
const texto = actions["lerTexto"]["value"]
const numero = actions["calcularTotal"]["value"]

// Combinando em uma expressão
return `Resultado: ${actions["buscarNome"]["value"]} (${actions["lerCodigo"]["value"]})`

tip

O editor mostra autocomplete dos IDs e campos disponíveis ao digitar actions[".

Acessando parâmetros do robô

Use a sintaxe de duplas chaves dentro de template literals para embutir parâmetros:

const url = `https://api.exemplo.com/{{PARAMETROS.endpoint}}`
const token = `{{PARAMETROS.token_api}}`
return token

Para segredos (parâmetros marcados como senha), use {{SEGREDOS.nome}}.

Caracteres de escape e barras invertidas

O campo Código (assim como qualquer campo do tipo Código em um campo dinâmico) é um bloco de código JavaScript de verdade — tudo que for digitado é interpretado com as regras de sintaxe do JavaScript antes de ser executado. Isso significa que qualquer caractere que precisaria de escape dentro de uma string JavaScript comum (aspas, quebras de linha, barra invertida, etc.) também precisa ser escapado aqui, exatamente como seria em um arquivo .js.

Isso é especialmente importante em caminhos de arquivo do Windows, que usam barra invertida (\) como separador. Como a barra invertida é o caractere de escape do JavaScript, um caminho copiado direto do Explorer vai gerar sequências de escape inválidas ou incorretas (\t, por exemplo, vira uma tabulação, não a letra "t"). Para usar o caminho como texto literal, escreva cada barra invertida em dobro (\\):

// Errado — "\t" é interpretado como tabulação, não como parte do caminho
const caminho = "C:\temp\arquivo.txt"

// Correto — barras duplicadas para escapar cada uma
const caminho = "C:\\temp\\arquivo.txt"
return caminho

A mesma regra vale dentro de template literals (` ... ``), inclusive quando o caminho está misturado com {{PARAMETROS...}} ou actions[...].

Não escapar símbolo do dólar "$"

Define se o símbolo $ no código será tratado literalmente, sem escape automático. Selecione Sim quando o código contiver templates literais com a sintaxe ${...} e o comportamento padrão de escape estiver interferindo.

Retornos