Verifique igualdade / Asserts equals
Verifica a igualdade entre textos ou números.
Figura 1 - Bloco Verifique igualdade
A função que utilizará este bloco deve ser criada dentro da pasta Testes (localização: Testes). Para mais detalhes de configuração, consulte a documentação Testes unitários.
É necessário que o nome da função que utilizará este bloco inicie com a palavra "Test" para que os testes sejam executados.
Compatibilidade
Bloco servidor: cronapi.unittest.Operations.fnAssertEquals()
Retorno
O bloco não possui retorno. No entanto, ao rodar os testes, ele compara os valores informados. Se forem iguais, na tela de resultados dos testes, a execução será retornada como sucesso. Caso contrário, o resultado será retornado como falha.
Parâmetros
Tipo
Define o tipo da comparação.
Posição: 1
Inglês: Type
Tipo: Objeto / Object
Exemplo: "Número"
Opções:
Número: realiza a comparação entre dois valores numéricos.
Texto: realiza a comparação entre dois textos.
Esperado
Recebe um valor numérico ou um texto.
Posição: 2
Inglês: Expected
Tipo: Texto ou Numérico / String or Numeric
Exemplo: 15
Atual
Recebe um valor numérico ou um texto.
Posição: 3
Inglês: Actual
Tipo: Texto ou Numérico / String or Numeric
Exemplo: 10
Delta
Caso o Tipo seja "Número", o parâmetro Delta define um valor de tolerância para a diferença entre os valores Esperado e Atual. Se essa diferença for menor ou igual ao valor de Delta, os números serão considerados equivalentes pelo bloco. Em outras palavras, o valor Atual será considerado igual ao Esperado sempre que estiver dentro do intervalo compreendido entre Esperado - Delta e Esperado + Delta.
Posição: 4
Inglês: Delta
Tipo: Numérico / Numeric
Exemplo: 5
Exemplo
Na função da imagem abaixo, utilizamos o bloco Verifique igualdade para validar se os valores informados nos parâmetros "Esperado" e "Atual" — 10 e 8, respectivamente — são considerados iguais. No parâmetro "Delta", definimos o valor 2, correspondente a diferença entre eles. Assim, embora os valores não sejam idênticos, o parâmetro Delta permite essa margem de tolerância, fazendo com que o bloco reconheça os números como iguais, já que a diferença está dentro do intervalo permitido (entre 8 e 12).
Figura 2 - Exemplo de uso do bloco Verifique igualdade
Na imagem a seguir, podemos visualizar o resultado da execução dos testes da função da Figura 2. Como o valor recebido no parâmetro "Delta" é igual a diferença entre os valores dos parâmetros "Esperado" e "Atual", o testes tiveram como resultado o valor "1" na coluna "Sucessos" (destaque 1 da Figura 2.1).
Para mais detalhes de execução dos testes, consulte o tópico "Rodando o teste" da documentação Testes unitários.
Figura 2.1 - Resultado da execução dos testes da função da Figura 2
Nesta página