doc: clarify assert.fail doc

PR-URL: #4186 Reviewed-By: Michaël Zasso <[email protected]> Reviewed-By: Roman Klauke <[email protected]> Reviewed-By: Minwoo Jung <[email protected]>
nodejs · Dec 29, 2015 · 31a9a65 · 31a9a65
1 parent 3b50842
commit 31a9a65
Showing 1 changed file with 3 additions and 2 deletions.
diff --git a/doc/api/assert.markdown b/doc/api/assert.markdown
@@ -62,8 +62,9 @@ Tests shallow, coercive equality with the equal comparison 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 `AssertionError`. If `message` is falsy, it displays the values for
+`actual` and `expected` separated by the provided `operator`. Otherwise, it
+displays `message` (and does not use `actual`, `expected`, and `operator`).
 
 ## assert.ifError(value)