Saltar al contenido

Referencia de la API node:assert

Auxiliares de aserción compatibles con Node

En esta página

La exportación del módulo se puede invocar y es la misma función que assert.ok:

import assert from "node:assert";

assert(1 + 1 === 2);
assert.strictEqual(1 + 1, 2);
assert.deepStrictEqual({ values: [1, 2] }, { values: [1, 2] });
await assert.rejects(async () => {
  throw new TypeError("nope");
}, TypeError);

Operaciones

Las aserciones admitidas incluyen:

  • ok, fail e ifError
  • equal, notEqual, strictEqual y notStrictEqual
  • deepEqual, notDeepEqual, deepStrictEqual, notDeepStrictEqual y partialDeepStrictEqual
  • throws, doesNotThrow, rejects y doesNotReject
  • match y doesNotMatch

assert.strict es una variante en modo estricto que se puede invocar. La comparación profunda admite ciclos y elementos integrados habituales como arrays, arrays tipados, fechas, expresiones regulares, mapas y conjuntos.

Las aserciones fallidas lanzan assert.AssertionError con code igual a ERR_ASSERTION y campos como actual, expected y operator. Elide indica en operator nombres de operación como strictEqual, en lugar de símbolos como ===.

Consulte la documentación de assert de Node.js para ver las formas de llamada estándar.

Reference

Status: Partial · 7 of 13 suite tests pass (53.8%) · since 1.1.0

Exports

ExportKindStatusNotes
ok()functionFullTests if value is truthy
equal()functionFullTests shallow equality between actual and expected using ==
notEqual()functionFullTests shallow inequality between actual and expected using !=
strictEqual()functionFullTests strict equality between actual and expected using ===
notStrictEqual()functionFullTests strict inequality between actual and expected using !==
deepEqual()functionFullTests for deep equality between actual and expected using abstract equality (==) for leaf comparisons
deepStrictEqual()functionFullTests for deep strict equality between actual and expected using strict equality (===) for leaf…
notDeepEqual()functionFullTests that actual is NOT deeply equal to expected (abstract equality)
notDeepStrictEqual()functionFullTests that actual is NOT deeply strictly equal to expected
throws()functionFullExpects the function fn to throw an error
doesNotThrow()functionFullAsserts that the function fn does not throw an error
rejects()functionFullAwaits the asyncFn promise (or calls it if it’s a function) and expects it to reject
doesNotReject()functionFullAwaits the asyncFn promise (or calls it if it’s a function) and expects it NOT to reject
fail()functionFullThrows an AssertionError unconditionally
ifError()functionFullIf value is truthy (not null/undefined/false), throws it
match()functionFullExpects string to match the regular expression regexp
doesNotMatch()functionFullExpects string NOT to match the regular expression regexp

Not implemented

Assert, assert/strict.Assert.

Tests: node-api node:assert: 7 pass, 6 fail, 0 error, 1 skipped. Failing: test-assert-async.js, test-assert-class-destructuring.js, test-assert-class.js, test-assert-deep.js, test-assert-esm-cjs-message-verify.js, test-assert.js.

¿Te resultó útil esta página?