Skip to content

Commit 4403975

Browse files
ameliavoncatjasnell
authored andcommitted
doc: argument types for assert methods
Refs: #9399 PR-URL: #11548 Reviewed-By: Timothy Gu <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Yuta Hiroto <[email protected]> Reviewed-By: James M Snell <[email protected]> Reviewed-By: Colin Ihrig <[email protected]>
1 parent 67a6b13 commit 4403975

File tree

1 file changed

+39
-0
lines changed

1 file changed

+39
-0
lines changed

doc/api/assert.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ the module.
1616
<!-- YAML
1717
added: v0.5.9
1818
-->
19+
* `value` {any}
20+
* `message` {any}
1921

2022
An alias of [`assert.ok()`][] .
2123

@@ -36,6 +38,9 @@ assert(false, 'it\'s false');
3638
<!-- YAML
3739
added: v0.1.21
3840
-->
41+
* `actual` {any}
42+
* `expected` {any}
43+
* `message` {any}
3944

4045
Tests for deep equality between the `actual` and `expected` parameters.
4146
Primitive values are compared with the equal comparison operator ( `==` ).
@@ -97,6 +102,9 @@ parameter is undefined, a default error message is assigned.
97102
<!-- YAML
98103
added: v1.2.0
99104
-->
105+
* `actual` {any}
106+
* `expected` {any}
107+
* `message` {any}
100108

101109
Generally identical to `assert.deepEqual()` with two exceptions. First,
102110
primitive values are compared using the strict equality operator ( `===` ).
@@ -121,6 +129,9 @@ parameter is undefined, a default error message is assigned.
121129
<!-- YAML
122130
added: v0.1.21
123131
-->
132+
* `block` {Function}
133+
* `error` {RegExp|Function}
134+
* `message` {any}
124135

125136
Asserts that the function `block` does not throw an error. See
126137
[`assert.throws()`][] for more details.
@@ -176,6 +187,9 @@ assert.doesNotThrow(
176187
<!-- YAML
177188
added: v0.1.21
178189
-->
190+
* `actual` {any}
191+
* `expected` {any}
192+
* `message` {any}
179193

180194
Tests shallow, coercive equality between the `actual` and `expected` parameters
181195
using the equal comparison operator ( `==` ).
@@ -202,6 +216,10 @@ parameter is undefined, a default error message is assigned.
202216
<!-- YAML
203217
added: v0.1.21
204218
-->
219+
* `actual` {any}
220+
* `expected` {any}
221+
* `message` {any}
222+
* `operator` {String}
205223

206224
Throws an `AssertionError`. If `message` is falsy, the error message is set as
207225
the values of `actual` and `expected` separated by the provided `operator`.
@@ -221,6 +239,7 @@ assert.fail(1, 2, 'whoops', '>');
221239
<!-- YAML
222240
added: v0.1.97
223241
-->
242+
* `value` {any}
224243

225244
Throws `value` if `value` is truthy. This is useful when testing the `error`
226245
argument in callbacks.
@@ -238,6 +257,9 @@ assert.ifError(new Error()); // Throws Error
238257
<!-- YAML
239258
added: v0.1.21
240259
-->
260+
* `actual` {any}
261+
* `expected` {any}
262+
* `message` {any}
241263

242264
Tests for any deep inequality. Opposite of [`assert.deepEqual()`][].
243265

@@ -282,6 +304,9 @@ parameter is undefined, a default error message is assigned.
282304
<!-- YAML
283305
added: v1.2.0
284306
-->
307+
* `actual` {any}
308+
* `expected` {any}
309+
* `message` {any}
285310

286311
Tests for deep strict inequality. Opposite of [`assert.deepStrictEqual()`][].
287312

@@ -303,6 +328,9 @@ the `message` parameter is undefined, a default error message is assigned.
303328
<!-- YAML
304329
added: v0.1.21
305330
-->
331+
* `actual` {any}
332+
* `expected` {any}
333+
* `message` {any}
306334

307335
Tests shallow, coercive inequality with the not equal comparison operator
308336
( `!=` ).
@@ -328,6 +356,9 @@ parameter is undefined, a default error message is assigned.
328356
<!-- YAML
329357
added: v0.1.21
330358
-->
359+
* `actual` {any}
360+
* `expected` {any}
361+
* `message` {any}
331362

332363
Tests strict inequality as determined by the strict not equal operator
333364
( `!==` ).
@@ -353,6 +384,8 @@ If the values are strictly equal, an `AssertionError` is thrown with a
353384
<!-- YAML
354385
added: v0.1.21
355386
-->
387+
* `value` {any}
388+
* `message` {any}
356389

357390
Tests if `value` is truthy. It is equivalent to
358391
`assert.equal(!!value, true, message)`.
@@ -378,6 +411,9 @@ assert.ok(false, 'it\'s false');
378411
<!-- YAML
379412
added: v0.1.21
380413
-->
414+
* `actual` {any}
415+
* `expected` {any}
416+
* `message` {any}
381417

382418
Tests strict equality as determined by the strict equality operator ( `===` ).
383419

@@ -402,6 +438,9 @@ If the values are not strictly equal, an `AssertionError` is thrown with a
402438
<!-- YAML
403439
added: v0.1.21
404440
-->
441+
* `block` {Function}
442+
* `error` {RegExp|Function}
443+
* `message` {any}
405444

406445
Expects the function `block` to throw an error.
407446

0 commit comments

Comments
 (0)