Ferramentas de CI/CD

Testador de Expressões do GitHub Actionsconfira a condição antes do push

Digite uma expressão e edite o contexto simulado para conferir o valor retornado.

Avaliação automática

Expressão

Contexto simulado JSON

Resultado

Valor retornado

Sem resultado

Tipo: Sem resultado

Condição if: Sem resultado

Expressão e contexto ficam neste navegador; nada é enviado ao GitHub ou ao nosso servidor.

OpçõesStatus anterior simulado

Só as funções de status usam esse valor simulado.

O resultado está desatualizado.

O teste de branch parece certo, mas o job foi ignorado? Use o Testador de Expressões do GitHub Actions para avaliar só aquela condição com o ref e o evento que você informar, sem criar outro commit de teste.

Para testar expressão GitHub Actions, mude github.ref, env ou inputs no JSON e compare os resultados. A página não busca dados reais do repositório nem executa o workflow.

Por que usar o Testador de Expressões do GitHub Actions?

O contexto usado fica visível, enquanto valor bruto, tipo e verdade no if aparecem separados.

Troque o contexto e veja a diferença

A mesma condição retorna verdadeiro em main e falso em outra referência. No Testador de Expressões do GitHub Actions, basta editar github.ref em vez de fazer push para testar.

Um contexto editável leva a dois estados booleanos diferentes.

Separe valor de verdade

Um OR lógico pode devolver um operando que não é booleano, mas que if considera verdadeiro. O Testador de Expressões do GitHub Actions mostra as duas saídas separadas.

Uma expressão lógica se divide em valor bruto azul e condição verdadeira verde.

Confira o que a condição realmente retorna

Delimite a expressão

Cole uma expressão sem invólucro, um `${{ … }}` completo ou uma linha `if:`. Texto adicional fora das chaves provoca erro para evitar um resultado parcial enganoso.

Há um exemplo com erro proposital para conferir a posição indicada.

Ajuste o contexto de teste

Edite github, env, inputs e matrix no JSON. A opção de sucesso, falha ou cancelamento fornece apenas o estado simulado das funções de status.

O env.DEPLOY padrão é string; use fromJSON para obter booleano ou número.

Leia valor e condição separadamente

`&&` e `||` podem devolver texto, que no if ainda pode ser verdadeiro. A avaliação automática atualiza após a edição; no modo manual use Ctrl/Cmd+Enter.

Cópia e download ficam bloqueados quando o resultado está antigo.

Valores, funções e contextos no mesmo painel

Motor oficial de expressões

contains, startsWith, endsWith, format, join, toJSON, fromJSON, case, operadores e filtros de objetos seguem o comportamento publicado pelo GitHub.

Contextos GitHub Actions editáveis

Informe github.ref ou event_name e outros campos. Nomes ausentes geram erro, em vez de receber valores inventados do runner.

Tipo e verdade da condição

Veja o valor JSON, seu tipo e o resultado da condição if GitHub Actions. Isso expõe operadores que retornam operandos, não apenas booleanos.

Limites do teste local

Não simula o workflow inteiro: Filtros on:, expansão de matrix e dependências de jobs ficam fora do escopo. Uma expressão verdadeira não garante que o job rode.
Status é apenas simulado: success(), failure(), cancelled() e always() usam a opção selecionada, não o histórico real das etapas anteriores.
Sem hash fictício: hashFiles() exige arquivos reais em GITHUB_WORKSPACE. A página mostra a impossibilidade de avaliar, sem fabricar um digest.
Você fornece o contexto: Secrets, API do GitHub e eventos em tempo real não são lidos. Para testar, use dados fictícios em campos sensíveis.

Dúvidas sobre o Testador de Expressões do GitHub Actions

Como avaliar uma expressão antes de executar o workflow?

Informe a expressão e um contexto representativo. O Testador de Expressões do GitHub Actions mostra o valor e a verdade no if sem iniciar um job.

Quando a condição if dispensa `${{ }}`?

Na condição if geralmente é possível omitir as chaves; em outros lugares elas podem ser necessárias. Este painel aceita os dois formatos completos.

Por que uma tarefa foi ignorada mesmo com if definido?

Além da expressão, o success() implícito, dependências e filtros de evento podem influir. O painel não reproduz a decisão do workflow inteiro.

Como converter texto em booleano ou número com fromJSON?

Passe uma string JSON válida para fromJSON, por exemplo fromJSON(env.DEPLOY). Um texto que não representa JSON válido causa erro.

Onde vejo os valores de contexto usados na avaliação?

Eles aparecem no editor JSON à esquerda. São valores que você digitou ou deixou no exemplo, nunca dados obtidos de uma execução real.

Encontrou um workflow que esta ferramenta avalia errado?

Use o Testador de Expressões do GitHub Actions

Volte ao Testador de Expressões do GitHub Actions com sua condição e um contexto sem segredos; confira o valor antes do próximo push.

Voltar para a ferramenta Ver ferramentas de CI/CD

Toda a análise acontece localmente no seu navegador.

Testador de Expressões do GitHub Actionsconfira a condição antes do push