Ir para o conteúdo
Promovaweb

Variáveis de ambiente: Expressões

17 variáveis das versões 1.123.92, 2.45.7 e 3.0.1

Motor que avalia as expressões, com isolamento, pool, memória, timeout e rastreamento das avaliações lentas. A lista sai do código de cada versão e das páginas de variáveis da documentação oficial, conferidos em 3 de novembro de 2026. Toda variável aceita o sufixo _FILE para ler o valor de um arquivo, útil para senhas e chaves em secrets do Docker.

  • Motor das expressões: vm, o padrão, roda cada expressão isolada no V8. legacy roda sem isolamento. quickjs, experimental, roda num sandbox WASM.

    Nas três linhas, o n8n avisa que o motor legacy não é mais considerado seguro e será removido. Retire a variável para usar o padrão vm.

    Tipo
    Enum
    Padrão
    vm
    Versões
    1.x aceita2.x aceita3.x aceita
    Valores
    • legacy
    • vm
    • quickjs
  • Permite que uma requisição de webhook de produção dispense o isolamento quando o trigger não avalia nenhuma expressão nessa fase. Com false, toda requisição recebe um isolamento.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Experimental. Reaproveita o cache de compilação do V8 para o pacote de execução das expressões, evitando compilar o mesmo código a cada isolamento. Só vale para o motor vm.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Motor de expressões usado pelo editor no navegador: legacy, o padrão, ou quickjs. É independente do motor do backend.

    Tipo
    Enum
    Padrão
    legacy
    Versões
    1.x não aceita2.x aceita3.x aceita
    Valores
    • legacy
    • quickjs
  • Tempo em segundos sem uso para o n8n esvaziar o pool de isolamentos de expressão. Sem valor, o pool continua aquecido.

    Tipo
    Number
    Padrão
    calculado pelo n8n
    Versões
    1.x aceita2.x aceita3.x aceita
  • Experimental. Só cria o isolamento quando uma expressão realmente precisa do motor. Trechos sem expressão não consomem isolamento.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Quantidade máxima de expressões já transformadas guardadas em cache.

    Tipo
    Number
    Padrão
    1024
    Versões
    1.x aceita2.x aceita3.x aceita
  • Limite de memória em MB de cada isolamento V8 das expressões. O mínimo é 8. Valor negativo deixa sem limite. Aceita só números inteiros.

    Tipo
    Number
    Padrão
    128
    Versões
    1.x aceita2.x aceita3.x aceita
  • Experimental. Avalia expressões simples direto no n8n, sem isolamento. As demais continuam no motor configurado.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Gera métricas, traces e logs da avaliação de expressões nos motores vm e quickjs. O motor legacy não gera esses sinais.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x aceita2.x aceita3.x aceita
  • Quantidade de isolamentos V8 prontos no pool para avaliar expressões.

    Tipo
    Number
    Padrão
    1
    Versões
    1.x aceita2.x aceita3.x aceita
  • Tempo em milissegundos a partir do qual uma avaliação de expressão é considerada lenta e ganha um span de trace.

    Tipo
    Number
    Padrão
    50
    Versões
    1.x aceita2.x aceita3.x aceita
  • Tempo limite em milissegundos de cada avaliação de expressão. Aceita só inteiros positivos. Zero ou valor negativo deixa a avaliação sem limite.

    Tipo
    Number
    Padrão
    5000
    Versões
    1.x aceita2.x aceita3.x aceita
  • Envia spans de OpenTelemetry das avaliações de expressão quando N8N_OTEL_ENABLED está ligada. As avaliações com erro ou lentas geram span. As demais entram por amostragem. O padrão passou de true na 1.x para false na 2.x.

    Tipo
    Boolean
    Padrão
    1.xtrue2.xfalse3.xfalse
    Versões
    1.x aceita2.x aceita3.x aceita
  • Taxa de amostragem, de 0 a 1, dos spans de expressões que terminam bem. Expressões lentas e com erro geram span independentemente da taxa.

    Tipo
    Number
    Padrão
    0
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_EXPRESSION_EVALUATOR
    • Fora do código atual
    • Fora da documentação

    Escolhia o avaliador de expressões antigo tmpl, substituído pelo tournament. Não tem mais efeito.

    Nas três linhas, o n8n avisa que trocou o tmpl pelo tournament e pede para remover a variável.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x não aceita3.x não aceita
  • N8N_EXPRESSION_REPORT_DIFFERENCE
    • Fora do código atual
    • Fora da documentação

    Relatava diferenças entre os avaliadores tmpl e tournament durante a troca. Não tem mais efeito.

    Nas três linhas, o n8n avisa que trocou o tmpl pelo tournament e pede para remover a variável.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x não aceita3.x não aceita