Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Testes e asserções

Um teste compara o comportamento observado com o esperado, enquanto uma asserção assinala que uma condição não foi satisfeita. Conheça um pequeno teste unitário que usa um módulo integrado do Node.js e perceba por que razão importam as regras de comparação e os casos-limite.

Versão: Syntax snippet: Requires ECMAScript 2015 or later because it uses Object.is, which was standardized in ECMAScript 2015. Executable example: verified in Node.js 24.22.2 using the built-in node:assert/strict module. This does not establish browser API support.

Sintaxe

function assertEqual(actual, expected, label) {
  if (!Object.is(actual, expected)) {
    throw new Error(label);
  }
}

Um teste verifica o comportamento de um programa para entradas e expectativas definidas. Se uma asserção falhar, o teste falha. Num teste unitário, concentre-se numa unidade pequena, como uma função: prepare as entradas, chame a função e verifique o resultado. A ausência de uma exceção, por si só, não demonstra que o resultado está correto.

O excerto de sintaxe define uma função personalizada, assertEqual. Usa Object.is e executa throw new Error(label) quando há uma diferença. Object.is considera NaN igual a NaN, distingue +0 de -0 e compara objetos pela identidade, não pelo conteúdo. Não é uma comparação profunda.

O exemplo executável não usa assertEqual. Importa o módulo integrado do Node.js node:assert/strict e chama assert.equal, que neste modo segue as regras de comparação de Object.is. As três asserções verificam a soma de dois números positivos, a soma de dois números simétricos e a cadeia de caracteres "0.3" obtida ao formatar a soma 0.1 + 0.2 com toFixed(1). A última asserção compara uma cadeia de caracteres, não o resultado numérico por formatar. Um erro de asserção não capturado interrompe o script antes de este apresentar a mensagem de sucesso.

Escolha tanto entradas comuns como casos-limite, de acordo com o contrato da função. Defina as expectativas independentemente da implementação em teste. Para verificar o próprio teste, altere deliberadamente uma expectativa e confirme que a asserção falha. O sucesso nestes casos não prova a correção para todas as entradas.

O excerto de sintaxe usa funcionalidades disponíveis desde ECMAScript 2015 ou de uma edição anterior e descritas na especificação ECMAScript. A API de asserções é descrita na documentação do Node.js. O exemplo requer Node.js, mas não precisa de APIs do browser nem de bibliotecas de terceiros. A presença de Node 24 num repositório não comprova o suporte de APIs do browser.

Exemplos

import assert from "node:assert/strict";

const add = (left, right) => left + right;
assert.equal(add(2, 3), 5);
assert.equal(add(-1, 1), 0);
assert.equal(add(0.1, 0.2).toFixed(1), "0.3");
console.log("3 assertions passed");

Resultado

3 assertions passed

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes