diff --git a/doc/api/assert.md b/doc/api/assert.md index ca7f048f9e04f1..a3cb02c7bca625 100644 --- a/doc/api/assert.md +++ b/doc/api/assert.md @@ -46,12 +46,11 @@ Primitive values are compared with the [Abstract Equality Comparison][] Only [enumerable "own" properties][] are considered. The [`assert.deepEqual()`][] implementation does not test the -[`[[Prototype]]`][prototype-spec] of objects, attached symbols, or -non-enumerable properties — for such checks, consider using -[`assert.deepStrictEqual()`][] instead. This can lead to some -potentially surprising results. For example, the following example does not -throw an `AssertionError` because the properties on the [`RegExp`][] object are -not enumerable: +[`[[Prototype]]`][prototype-spec] of objects or enumerable own [`Symbol`][] +properties. For such checks, consider using [assert.deepStrictEqual()][] +instead. [`assert.deepEqual()`][] can have potentially surprising results. The +following example does not throw an `AssertionError` because the properties on +the [RegExp][] object are not enumerable: ```js // WARNING: This does not throw an AssertionError! @@ -109,6 +108,9 @@ parameter is an instance of an `Error` then it will be thrown instead of the