Browse Source

doc refactor: assert

v0.9.1-release
isaacs 13 years ago
parent
commit
97ee38707b
  1. 24
      doc/api/assert.markdown

24
doc/api/assert.markdown

@ -1,41 +1,41 @@
## Assert # Assert
This module is used for writing unit tests for your applications, you can This module is used for writing unit tests for your applications, you can
access it with `require('assert')`. access it with `require('assert')`.
### assert.fail(actual, expected, message, operator) ## assert.fail(actual, expected, message, operator)
Throws an exception that displays the values for `actual` and `expected` separated by the provided operator. Throws an exception that displays the values for `actual` and `expected` separated by the provided operator.
### assert(value, message), assert.ok(value, [message]) ## assert(value, message), assert.ok(value, [message])
Tests if value is a `true` value, it is equivalent to `assert.equal(true, value, message);` Tests if value is a `true` value, it is equivalent to `assert.equal(true, value, message);`
### assert.equal(actual, expected, [message]) ## assert.equal(actual, expected, [message])
Tests shallow, coercive equality with the equal comparison operator ( `==` ). Tests shallow, coercive equality with the equal comparison operator ( `==` ).
### assert.notEqual(actual, expected, [message]) ## assert.notEqual(actual, expected, [message])
Tests shallow, coercive non-equality with the not equal comparison operator ( `!=` ). Tests shallow, coercive non-equality with the not equal comparison operator ( `!=` ).
### assert.deepEqual(actual, expected, [message]) ## assert.deepEqual(actual, expected, [message])
Tests for deep equality. Tests for deep equality.
### assert.notDeepEqual(actual, expected, [message]) ## assert.notDeepEqual(actual, expected, [message])
Tests for any deep inequality. Tests for any deep inequality.
### assert.strictEqual(actual, expected, [message]) ## assert.strictEqual(actual, expected, [message])
Tests strict equality, as determined by the strict equality operator ( `===` ) Tests strict equality, as determined by the strict equality operator ( `===` )
### assert.notStrictEqual(actual, expected, [message]) ## assert.notStrictEqual(actual, expected, [message])
Tests strict non-equality, as determined by the strict not equal operator ( `!==` ) Tests strict non-equality, as determined by the strict not equal operator ( `!==` )
### assert.throws(block, [error], [message]) ## assert.throws(block, [error], [message])
Expects `block` to throw an error. `error` can be constructor, regexp or Expects `block` to throw an error. `error` can be constructor, regexp or
validation function. validation function.
@ -72,11 +72,11 @@ Custom error validation:
"unexpected error" "unexpected error"
); );
### assert.doesNotThrow(block, [error], [message]) ## assert.doesNotThrow(block, [error], [message])
Expects `block` not to throw an error, see assert.throws for details. Expects `block` not to throw an error, see assert.throws for details.
### assert.ifError(value) ## assert.ifError(value)
Tests if value is not a false value, throws if it is a true value. Useful when Tests if value is not a false value, throws if it is a true value. Useful when
testing the first argument, `error` in callbacks. testing the first argument, `error` in callbacks.

Loading…
Cancel
Save