CKTIS / JavaScript
Pruebas y aserciones
Una prueba compara el comportamiento observado con el esperado, mientras que una aserción señala que no se cumple una condición. Aprende con una pequeña prueba unitaria que usa un módulo integrado de Node.js y descubre por qué importan las reglas de comparación y los casos límite.
Versión: 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.
Sintaxis
function assertEqual(actual, expected, label) {
if (!Object.is(actual, expected)) {
throw new Error(label);
}
}Una prueba comprueba el comportamiento de un programa con entradas y expectativas definidas. Si falla una aserción, falla la prueba. En una prueba unitaria, céntrate en una unidad pequeña, como una función: prepara las entradas, llama a la función y comprueba el resultado. Que no se produzca una excepción no demuestra por sí solo que el resultado sea correcto.
El fragmento de sintaxis define una función propia, assertEqual. Usa Object.is y ejecuta throw new Error(label) si hay una discrepancia. Object.is considera que NaN es igual a NaN, distingue +0 de -0 y compara los objetos por identidad, no por contenido. No es una comparación profunda.
El ejemplo ejecutable no usa assertEqual. Importa el módulo integrado de Node.js node:assert/strict y llama a assert.equal, que en este modo aplica las reglas de comparación de Object.is. Las tres aserciones comprueban la suma de dos números positivos, la suma de dos números opuestos y la cadena "0.3" que se obtiene al formatear la suma 0.1 + 0.2 con toFixed(1). La última aserción compara una cadena, no el resultado numérico sin formatear. Un error de aserción no capturado detiene el script antes de que se imprima el mensaje de éxito.
Elige tanto entradas habituales como casos límite según el contrato de la función. Determina las expectativas independientemente de la implementación que estás probando. Para comprobar la propia prueba, cambia deliberadamente una expectativa y confirma que la aserción falla. Superar estos casos no demuestra que el programa sea correcto para todas las entradas.
El fragmento de sintaxis usa características disponibles desde ECMAScript 2015 o una edición anterior y descritas en la especificación ECMAScript. La documentación de Node.js describe la API de aserciones. El ejemplo requiere Node.js, pero no necesita API de navegador ni bibliotecas de terceros. Que un repositorio tenga Node 24 no demuestra que admita API de navegador.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.