diff --git a/doc/api/assert.markdown b/doc/api/assert.markdown index 91628506a000b7..1ef9be61354b85 100644 --- a/doc/api/assert.markdown +++ b/doc/api/assert.markdown @@ -2,58 +2,112 @@ Stability: 5 - Locked + + +このモジュールはアプリケーションの単体テストを記述するために使用され、 +`require('assert')` でアクセスできます。 ## assert.fail(actual, expected, message, operator) + + +`actual` と `expected` を `operator` で区切ったメッセージを持つ例外を +スローします。 -## assert(value, message), assert.ok(value[, message]) +## assert(value[, message]), assert.ok(value[, message]) + + +`value` が truthy かテストします、 +これは `assert.equal(true, !!value, message);` と等価です。 ## assert.equal(actual, expected[, message]) + + +`==` 演算子を強制して浅い同値性をテストします。 ## assert.notEqual(actual, expected[, message]) + + +`!=` 演算子を強制して浅い非同値性をテストします。 ## assert.deepEqual(actual, expected[, message]) -Tests for deep equality. Primitive values are compared with the equal comparison -operator ( `==` ). Doesn't take object prototypes into account. + + +深い同値性をテストします。 ## assert.notDeepEqual(actual, expected[, message]) -Tests for any deep inequality. Opposite of `assert.deepEqual`. + + +深い非同値性をテストします。 ## assert.strictEqual(actual, expected[, message]) + + +`===` 演算子で厳密な同値性をテストします。 ## assert.notStrictEqual(actual, expected[, message]) -Tests strict non-equality, as determined by the strict not equal -operator ( `!==` ) + + +`!==` 演算子で厳密な非同値性をテストします。 ## assert.deepStrictEqual(actual, expected[, message]) + + +深い同値性をテストします。プリミティブな値は厳密等価演算子 (`===`) で評価されます。 ## assert.notDeepStrictEqual(actual, expected[, message]) + + +深い非同値性をテストします。`assert.deepStrictEqual`の反対です。 ## assert.throws(block[, error][, message]) -Expects `block` to throw an error. `error` can be constructor, `RegExp` or + + +`block` がエラーをスローすることを期待します。 +`error` はコンストラクタ、正規表現、または検証関数にすることができます。 + + +コンストラクタを使って instanceof で検証: assert.throws( function() { @@ -62,7 +116,11 @@ Validate instanceof using constructor: Error ); + + +正規表現を使ってエラーメッセージを検証: assert.throws( function() { @@ -71,7 +129,11 @@ Validate error message using RegExp: /value/ ); + + +独自のエラー検証: assert.throws( function() { @@ -85,11 +147,22 @@ Custom error validation: "unexpected error" ); -## assert.doesNotThrow(block[, message]) +## assert.doesNotThrow(block, [message]) + + -Expects `block` not to throw an error, see `assert.throws` for details. +`block` がエラーをスローしないことを期待します。 +詳細は assert.throws を参照してください。 ## assert.ifError(value) + + +`value` が false でないことをテストし、true だったらそれをスローします。 +コールバックの第 1 引数である `error` をテストするのに便利です。 +