chai 5.0.3 → 5.1.1

package/lib/chai/interface/assert.js

@@ -8,7 +8,6 @@ import * as chai from '../../../index.js';
 import {Assertion} from '../assertion.js';
 import {flag, inspect} from '../utils/index.js';
 import {AssertionError} from 'assertion-error';
-import {type} from '../utils/type-detect.js';
 
 /**
  * ### assert(expression, message)
@@ -18,14 +17,13 @@ import {type} from '../utils/type-detect.js';
  *     assert('foo' !== 'bar', 'foo is not bar');
  *     assert(Array.isArray([]), 'empty arrays are arrays');
  *
- * @param {Mixed} expression to test for truthiness
- * @param {String} message to display on error
+ * @param {unknown} express - expression to test for truthiness
+ * @param {string} errmsg - message to display on error
  * @name assert
  * @namespace Assert
- * @api public
+ * @public
  */
-
-function assert(express, errmsg) {
+export function assert(express, errmsg) {
   var test = new Assertion(null, null, chai.assert, true);
   test.assert(
       express
@@ -34,8 +32,6 @@ function assert(express, errmsg) {
   );
 }
 
-export {assert};
-
 /**
  * ### .fail([message])
  * ### .fail(actual, expected, [message], [operator])
@@ -50,14 +46,13 @@ export {assert};
  *     assert.fail(1, 2, undefined, ">");
  *
  * @name fail
- * @param {Mixed} actual
- * @param {Mixed} expected
- * @param {String} message
- * @param {String} operator
+ * @param {unknown} actual
+ * @param {unknown} expected
+ * @param {string} message
+ * @param {string} operator
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.fail = function (actual, expected, message, operator) {
   if (arguments.length < 2) {
       // Comply with Node's fail([message]) interface
@@ -84,12 +79,11 @@ assert.fail = function (actual, expected, message, operator) {
  *
  * @name isOk
  * @alias ok
- * @param {Mixed} object to test
- * @param {String} message
+ * @param {unknown} val object to test
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isOk = function (val, msg) {
   new Assertion(val, msg, assert.isOk, true).is.ok;
 };
@@ -104,12 +98,11 @@ assert.isOk = function (val, msg) {
  *
  * @name isNotOk
  * @alias notOk
- * @param {Mixed} object to test
- * @param {String} message
+ * @param {unknown} val object to test
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isNotOk = function (val, msg) {
   new Assertion(val, msg, assert.isNotOk, true).is.not.ok;
 };
@@ -122,13 +115,12 @@ assert.isNotOk = function (val, msg) {
  *     assert.equal(3, '3', '== coerces values to strings');
  *
  * @name equal
- * @param {Mixed} actual
- * @param {Mixed} expected
- * @param {String} message
+ * @param {unknown} act
+ * @param {unknown} exp
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.equal = function (act, exp, msg) {
   var test = new Assertion(act, msg, assert.equal, true);
 
@@ -150,13 +142,12 @@ assert.equal = function (act, exp, msg) {
  *     assert.notEqual(3, 4, 'these numbers are not equal');
  *
  * @name notEqual
- * @param {Mixed} actual
- * @param {Mixed} expected
- * @param {String} message
+ * @param {unknown} act
+ * @param {unknown} exp
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notEqual = function (act, exp, msg) {
   var test = new Assertion(act, msg, assert.notEqual, true);
 
@@ -178,13 +169,12 @@ assert.notEqual = function (act, exp, msg) {
  *     assert.strictEqual(true, true, 'these booleans are strictly equal');
  *
  * @name strictEqual
- * @param {Mixed} actual
- * @param {Mixed} expected
- * @param {String} message
+ * @param {unknown} act
+ * @param {unknown} exp
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.strictEqual = function (act, exp, msg) {
   new Assertion(act, msg, assert.strictEqual, true).to.equal(exp);
 };
@@ -197,13 +187,12 @@ assert.strictEqual = function (act, exp, msg) {
  *     assert.notStrictEqual(3, '3', 'no coercion for strict equality');
  *
  * @name notStrictEqual
- * @param {Mixed} actual
- * @param {Mixed} expected
- * @param {String} message
+ * @param {unknown} act
+ * @param {unknown} exp
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notStrictEqual = function (act, exp, msg) {
   new Assertion(act, msg, assert.notStrictEqual, true).to.not.equal(exp);
 };
@@ -216,14 +205,13 @@ assert.notStrictEqual = function (act, exp, msg) {
  *     assert.deepEqual({ tea: 'green' }, { tea: 'green' });
  *
  * @name deepEqual
- * @param {Mixed} actual
- * @param {Mixed} expected
- * @param {String} message
+ * @param {unknown} act
+ * @param {unknown} exp
+ * @param {string} msg
  * @alias deepStrictEqual
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.deepEqual = assert.deepStrictEqual = function (act, exp, msg) {
   new Assertion(act, msg, assert.deepEqual, true).to.eql(exp);
 };
@@ -236,18 +224,17 @@ assert.deepEqual = assert.deepStrictEqual = function (act, exp, msg) {
  *     assert.notDeepEqual({ tea: 'green' }, { tea: 'jasmine' });
  *
  * @name notDeepEqual
- * @param {Mixed} actual
- * @param {Mixed} expected
- * @param {String} message
+ * @param {unknown} act
+ * @param {unknown} exp
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notDeepEqual = function (act, exp, msg) {
   new Assertion(act, msg, assert.notDeepEqual, true).to.not.eql(exp);
 };
 
- /**
+/**
  * ### .isAbove(valueToCheck, valueToBeAbove, [message])
  *
  * Asserts `valueToCheck` is strictly greater than (>) `valueToBeAbove`.
@@ -255,18 +242,17 @@ assert.notDeepEqual = function (act, exp, msg) {
  *     assert.isAbove(5, 2, '5 is strictly greater than 2');
  *
  * @name isAbove
- * @param {Mixed} valueToCheck
- * @param {Mixed} valueToBeAbove
- * @param {String} message
+ * @param {unknown} val
+ * @param {unknown} abv
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isAbove = function (val, abv, msg) {
   new Assertion(val, msg, assert.isAbove, true).to.be.above(abv);
 };
 
- /**
+/**
  * ### .isAtLeast(valueToCheck, valueToBeAtLeast, [message])
  *
  * Asserts `valueToCheck` is greater than or equal to (>=) `valueToBeAtLeast`.
@@ -275,18 +261,17 @@ assert.isAbove = function (val, abv, msg) {
  *     assert.isAtLeast(3, 3, '3 is greater or equal to 3');
  *
  * @name isAtLeast
- * @param {Mixed} valueToCheck
- * @param {Mixed} valueToBeAtLeast
- * @param {String} message
+ * @param {unknown} val
+ * @param {unknown} atlst
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isAtLeast = function (val, atlst, msg) {
   new Assertion(val, msg, assert.isAtLeast, true).to.be.least(atlst);
 };
 
- /**
+/**
  * ### .isBelow(valueToCheck, valueToBeBelow, [message])
  *
  * Asserts `valueToCheck` is strictly less than (<) `valueToBeBelow`.
@@ -294,18 +279,17 @@ assert.isAtLeast = function (val, atlst, msg) {
  *     assert.isBelow(3, 6, '3 is strictly less than 6');
  *
  * @name isBelow
- * @param {Mixed} valueToCheck
- * @param {Mixed} valueToBeBelow
- * @param {String} message
+ * @param {unknown} val
+ * @param {unknown} blw
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isBelow = function (val, blw, msg) {
   new Assertion(val, msg, assert.isBelow, true).to.be.below(blw);
 };
 
- /**
+/**
  * ### .isAtMost(valueToCheck, valueToBeAtMost, [message])
  *
  * Asserts `valueToCheck` is less than or equal to (<=) `valueToBeAtMost`.
@@ -314,13 +298,12 @@ assert.isBelow = function (val, blw, msg) {
  *     assert.isAtMost(4, 4, '4 is less than or equal to 4');
  *
  * @name isAtMost
- * @param {Mixed} valueToCheck
- * @param {Mixed} valueToBeAtMost
- * @param {String} message
+ * @param {unknown} val
+ * @param {unknown} atmst
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isAtMost = function (val, atmst, msg) {
   new Assertion(val, msg, assert.isAtMost, true).to.be.most(atmst);
 };
@@ -334,12 +317,11 @@ assert.isAtMost = function (val, atmst, msg) {
  *     assert.isTrue(teaServed, 'the tea has been served');
  *
  * @name isTrue
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isTrue = function (val, msg) {
   new Assertion(val, msg, assert.isTrue, true).is['true'];
 };
@@ -353,12 +335,11 @@ assert.isTrue = function (val, msg) {
  *     assert.isNotTrue(tea, 'great, time for tea!');
  *
  * @name isNotTrue
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isNotTrue = function (val, msg) {
   new Assertion(val, msg, assert.isNotTrue, true).to.not.equal(true);
 };
@@ -372,12 +353,11 @@ assert.isNotTrue = function (val, msg) {
  *     assert.isFalse(teaServed, 'no tea yet? hmm...');
  *
  * @name isFalse
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isFalse = function (val, msg) {
   new Assertion(val, msg, assert.isFalse, true).is['false'];
 };
@@ -391,12 +371,11 @@ assert.isFalse = function (val, msg) {
  *     assert.isNotFalse(tea, 'great, time for tea!');
  *
  * @name isNotFalse
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isNotFalse = function (val, msg) {
   new Assertion(val, msg, assert.isNotFalse, true).to.not.equal(false);
 };
@@ -409,12 +388,11 @@ assert.isNotFalse = function (val, msg) {
  *     assert.isNull(err, 'there was no error');
  *
  * @name isNull
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isNull = function (val, msg) {
   new Assertion(val, msg, assert.isNull, true).to.equal(null);
 };
@@ -428,12 +406,11 @@ assert.isNull = function (val, msg) {
  *     assert.isNotNull(tea, 'great, time for tea!');
  *
  * @name isNotNull
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isNotNull = function (val, msg) {
   new Assertion(val, msg, assert.isNotNull, true).to.not.equal(null);
 };
@@ -446,12 +423,11 @@ assert.isNotNull = function (val, msg) {
  *     assert.isNaN(NaN, 'NaN is NaN');
  *
  * @name isNaN
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isNaN = function (val, msg) {
   new Assertion(val, msg, assert.isNaN, true).to.be.NaN;
 };
@@ -464,13 +440,13 @@ assert.isNaN = function (val, msg) {
  *     assert.isNotNaN(4, '4 is not NaN');
  *
  * @name isNotNaN
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} value
+ * @param {string} message
  * @namespace Assert
- * @api public
+ * @public
  */
-assert.isNotNaN = function (val, msg) {
-  new Assertion(val, msg, assert.isNotNaN, true).not.to.be.NaN;
+assert.isNotNaN = function (value, message) {
+  new Assertion(value, message, assert.isNotNaN, true).not.to.be.NaN;
 };
 
 /**
@@ -479,16 +455,14 @@ assert.isNotNaN = function (val, msg) {
  * Asserts that the target is neither `null` nor `undefined`.
  *
  *     var foo = 'hi';
- *
  *     assert.exists(foo, 'foo is neither `null` nor `undefined`');
  *
  * @name exists
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.exists = function (val, msg) {
   new Assertion(val, msg, assert.exists, true).to.exist;
 };
@@ -499,18 +473,17 @@ assert.exists = function (val, msg) {
  * Asserts that the target is either `null` or `undefined`.
  *
  *     var bar = null
- *       , baz;
+ *     , baz;
  *
  *     assert.notExists(bar);
  *     assert.notExists(baz, 'baz is either null or undefined');
  *
  * @name notExists
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notExists = function (val, msg) {
   new Assertion(val, msg, assert.notExists, true).to.not.exist;
 };
@@ -524,12 +497,11 @@ assert.notExists = function (val, msg) {
  *     assert.isUndefined(tea, 'no tea defined');
  *
  * @name isUndefined
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isUndefined = function (val, msg) {
   new Assertion(val, msg, assert.isUndefined, true).to.equal(undefined);
 };
@@ -543,12 +515,11 @@ assert.isUndefined = function (val, msg) {
  *     assert.isDefined(tea, 'tea has been defined');
  *
  * @name isDefined
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isDefined = function (val, msg) {
   new Assertion(val, msg, assert.isDefined, true).to.not.equal(undefined);
 };
@@ -562,13 +533,13 @@ assert.isDefined = function (val, msg) {
  *     assert.isCallable(serveTea, 'great, we can have tea now');
  *
  * @name isCallable
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} value
+ * @param {string} message
  * @namespace Assert
- * @api public
+ * @public
  */
-assert.isCallable = function (val, msg) {
-  new Assertion(val, msg, assert.isCallable, true).is.callable;
+assert.isCallable = function (value, message) {
+  new Assertion(value, message, assert.isCallable, true).is.callable;
 }
 
 /**
@@ -580,13 +551,13 @@ assert.isCallable = function (val, msg) {
  *     assert.isNotCallable(serveTea, 'great, we have listed the steps');
  *
  * @name isNotCallable
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} value
+ * @param {string} message
  * @namespace Assert
- * @api public
+ * @public
  */
-assert.isNotCallable = function (val, msg) {
-  new Assertion(val, msg, assert.isNotCallable, true).is.not.callable;
+assert.isNotCallable = function (value, message) {
+  new Assertion(value, message, assert.isNotCallable, true).is.not.callable;
 };
 
 /**
@@ -599,12 +570,11 @@ assert.isNotCallable = function (val, msg) {
  *     assert.isObject(selection, 'tea selection is an object');
  *
  * @name isObject
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isObject = function (val, msg) {
   new Assertion(val, msg, assert.isObject, true).to.be.a('object');
 };
@@ -619,12 +589,11 @@ assert.isObject = function (val, msg) {
  *     assert.isNotObject(null, 'null is not an object');
  *
  * @name isNotObject
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isNotObject = function (val, msg) {
   new Assertion(val, msg, assert.isNotObject, true).to.not.be.a('object');
 };
@@ -638,12 +607,11 @@ assert.isNotObject = function (val, msg) {
  *     assert.isArray(menu, 'what kind of tea do we want?');
  *
  * @name isArray
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isArray = function (val, msg) {
   new Assertion(val, msg, assert.isArray, true).to.be.an('array');
 };
@@ -657,12 +625,11 @@ assert.isArray = function (val, msg) {
  *     assert.isNotArray(menu, 'what kind of tea do we want?');
  *
  * @name isNotArray
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isNotArray = function (val, msg) {
   new Assertion(val, msg, assert.isNotArray, true).to.not.be.an('array');
 };
@@ -676,12 +643,11 @@ assert.isNotArray = function (val, msg) {
  *     assert.isString(teaOrder, 'order placed');
  *
  * @name isString
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isString = function (val, msg) {
   new Assertion(val, msg, assert.isString, true).to.be.a('string');
 };
@@ -695,12 +661,11 @@ assert.isString = function (val, msg) {
  *     assert.isNotString(teaOrder, 'order placed');
  *
  * @name isNotString
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isNotString = function (val, msg) {
   new Assertion(val, msg, assert.isNotString, true).to.not.be.a('string');
 };
@@ -714,12 +679,11 @@ assert.isNotString = function (val, msg) {
  *     assert.isNumber(cups, 'how many cups');
  *
  * @name isNumber
- * @param {Number} value
- * @param {String} message
+ * @param {number} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isNumber = function (val, msg) {
   new Assertion(val, msg, assert.isNumber, true).to.be.a('number');
 };
@@ -733,33 +697,30 @@ assert.isNumber = function (val, msg) {
  *     assert.isNotNumber(cups, 'how many cups');
  *
  * @name isNotNumber
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isNotNumber = function (val, msg) {
   new Assertion(val, msg, assert.isNotNumber, true).to.not.be.a('number');
 };
 
  /**
- * ### .isFinite(value, [message])
- *
- * Asserts that `value` is a finite number. Unlike `.isNumber`, this will fail for `NaN` and `Infinity`.
- *
- *     var cups = 2;
- *     assert.isFinite(cups, 'how many cups');
- *
- *     assert.isFinite(NaN); // throws
- *
- * @name isFinite
- * @param {Number} value
- * @param {String} message
- * @namespace Assert
- * @api public
- */
-
+  * ### .isFinite(value, [message])
+  *
+  * Asserts that `value` is a finite number. Unlike `.isNumber`, this will fail for `NaN` and `Infinity`.
+  *
+  *     var cups = 2;
+  *     assert.isFinite(cups, 'how many cups');
+  *     assert.isFinite(NaN); // throws
+  *
+  * @name isFinite
+  * @param {number} val
+  * @param {string} msg
+  * @namespace Assert
+  * @public
+  */
 assert.isFinite = function (val, msg) {
   new Assertion(val, msg, assert.isFinite, true).to.be.finite;
 };
@@ -770,18 +731,17 @@ assert.isFinite = function (val, msg) {
  * Asserts that `value` is a boolean.
  *
  *     var teaReady = true
- *       , teaServed = false;
+ *     , teaServed = false;
  *
  *     assert.isBoolean(teaReady, 'is the tea ready');
  *     assert.isBoolean(teaServed, 'has tea been served');
  *
  * @name isBoolean
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isBoolean = function (val, msg) {
   new Assertion(val, msg, assert.isBoolean, true).to.be.a('boolean');
 };
@@ -792,18 +752,17 @@ assert.isBoolean = function (val, msg) {
  * Asserts that `value` is _not_ a boolean.
  *
  *     var teaReady = 'yep'
- *       , teaServed = 'nope';
+ *     , teaServed = 'nope';
  *
  *     assert.isNotBoolean(teaReady, 'is the tea ready');
  *     assert.isNotBoolean(teaServed, 'has tea been served');
  *
  * @name isNotBoolean
- * @param {Mixed} value
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isNotBoolean = function (val, msg) {
   new Assertion(val, msg, assert.isNotBoolean, true).to.not.be.a('boolean');
 };
@@ -822,13 +781,12 @@ assert.isNotBoolean = function (val, msg) {
  *     assert.typeOf(undefined, 'undefined', 'we have an undefined');
  *
  * @name typeOf
- * @param {Mixed} value
- * @param {String} name
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} type
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.typeOf = function (val, type, msg) {
   new Assertion(val, msg, assert.typeOf, true).to.be.a(type);
 };
@@ -842,15 +800,14 @@ assert.typeOf = function (val, type, msg) {
  *     assert.notTypeOf('tea', 'number', 'strings are not numbers');
  *
  * @name notTypeOf
- * @param {Mixed} value
- * @param {String} typeof name
- * @param {String} message
+ * @param {unknown} value
+ * @param {string} type
+ * @param {string} message
  * @namespace Assert
- * @api public
+ * @public
  */
-
-assert.notTypeOf = function (val, type, msg) {
-  new Assertion(val, msg, assert.notTypeOf, true).to.not.be.a(type);
+assert.notTypeOf = function (value, type, message) {
+  new Assertion(value, message, assert.notTypeOf, true).to.not.be.a(type);
 };
 
 /**
@@ -859,18 +816,17 @@ assert.notTypeOf = function (val, type, msg) {
  * Asserts that `value` is an instance of `constructor`.
  *
  *     var Tea = function (name) { this.name = name; }
- *       , chai = new Tea('chai');
+ *     , chai = new Tea('chai');
  *
  *     assert.instanceOf(chai, Tea, 'chai is an instance of tea');
  *
  * @name instanceOf
- * @param {Object} object
- * @param {Constructor} constructor
- * @param {String} message
+ * @param {object} val
+ * @param {object} type
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.instanceOf = function (val, type, msg) {
   new Assertion(val, msg, assert.instanceOf, true).to.be.instanceOf(type);
 };
@@ -881,18 +837,17 @@ assert.instanceOf = function (val, type, msg) {
  * Asserts `value` is not an instance of `constructor`.
  *
  *     var Tea = function (name) { this.name = name; }
- *       , chai = new String('chai');
+ *     , chai = new String('chai');
  *
  *     assert.notInstanceOf(chai, Tea, 'chai is not an instance of tea');
  *
  * @name notInstanceOf
- * @param {Object} object
- * @param {Constructor} constructor
- * @param {String} message
+ * @param {object} val
+ * @param {object} type
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notInstanceOf = function (val, type, msg) {
   new Assertion(val, msg, assert.notInstanceOf, true)
     .to.not.be.instanceOf(type);
@@ -916,19 +871,18 @@ assert.notInstanceOf = function (val, type, msg) {
  * and strictly equal to the given property value. For instance:
  *
  *     var obj1 = {a: 1}
- *       , obj2 = {b: 2};
+ *     , obj2 = {b: 2};
  *     assert.include([obj1, obj2], obj1);
  *     assert.include({foo: obj1, bar: obj2}, {foo: obj1});
  *     assert.include({foo: obj1, bar: obj2}, {foo: obj1, bar: obj2});
  *
  * @name include
- * @param {Array|String} haystack
- * @param {Mixed} needle
- * @param {String} message
+ * @param {Array | string} exp
+ * @param {unknown} inc
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.include = function (exp, inc, msg) {
   new Assertion(exp, msg, assert.include, true).include(inc);
 };
@@ -952,19 +906,18 @@ assert.include = function (exp, inc, msg) {
  * property value. For instance:
  *
  *     var obj1 = {a: 1}
- *       , obj2 = {b: 2};
+ *     , obj2 = {b: 2};
  *     assert.notInclude([obj1, obj2], {a: 1});
  *     assert.notInclude({foo: obj1, bar: obj2}, {foo: {a: 1}});
  *     assert.notInclude({foo: obj1, bar: obj2}, {foo: obj1, bar: {b: 2}});
  *
  * @name notInclude
- * @param {Array|String} haystack
- * @param {Mixed} needle
- * @param {String} message
+ * @param {Array | string} exp
+ * @param {unknown} inc
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notInclude = function (exp, inc, msg) {
   new Assertion(exp, msg, assert.notInclude, true).not.include(inc);
 };
@@ -977,19 +930,18 @@ assert.notInclude = function (exp, inc, msg) {
  * Deep equality is used.
  *
  *     var obj1 = {a: 1}
- *       , obj2 = {b: 2};
+ *     , obj2 = {b: 2};
  *     assert.deepInclude([obj1, obj2], {a: 1});
  *     assert.deepInclude({foo: obj1, bar: obj2}, {foo: {a: 1}});
  *     assert.deepInclude({foo: obj1, bar: obj2}, {foo: {a: 1}, bar: {b: 2}});
  *
  * @name deepInclude
- * @param {Array|String} haystack
- * @param {Mixed} needle
- * @param {String} message
+ * @param {Array | string} exp
+ * @param {unknown} inc
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.deepInclude = function (exp, inc, msg) {
   new Assertion(exp, msg, assert.deepInclude, true).deep.include(inc);
 };
@@ -1002,19 +954,18 @@ assert.deepInclude = function (exp, inc, msg) {
  * Deep equality is used.
  *
  *     var obj1 = {a: 1}
- *       , obj2 = {b: 2};
+ *     , obj2 = {b: 2};
  *     assert.notDeepInclude([obj1, obj2], {a: 9});
  *     assert.notDeepInclude({foo: obj1, bar: obj2}, {foo: {a: 9}});
  *     assert.notDeepInclude({foo: obj1, bar: obj2}, {foo: {a: 1}, bar: {b: 9}});
  *
  * @name notDeepInclude
- * @param {Array|String} haystack
- * @param {Mixed} needle
- * @param {String} message
+ * @param {Array | string} exp
+ * @param {unknown} inc
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notDeepInclude = function (exp, inc, msg) {
   new Assertion(exp, msg, assert.notDeepInclude, true).not.deep.include(inc);
 };
@@ -1033,13 +984,12 @@ assert.notDeepInclude = function (exp, inc, msg) {
  *     assert.nestedInclude({'a': {'[b]': 'x'}}, {'a.\\[b\\]': 'x'});
  *
  * @name nestedInclude
- * @param {Object} haystack
- * @param {Object} needle
- * @param {String} message
+ * @param {object} exp
+ * @param {object} inc
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.nestedInclude = function (exp, inc, msg) {
   new Assertion(exp, msg, assert.nestedInclude, true).nested.include(inc);
 };
@@ -1058,13 +1008,12 @@ assert.nestedInclude = function (exp, inc, msg) {
  *     assert.notNestedInclude({'a': {'[b]': 'x'}}, {'a.\\[b\\]': 'y'});
  *
  * @name notNestedInclude
- * @param {Object} haystack
- * @param {Object} needle
- * @param {String} message
+ * @param {object} exp
+ * @param {object} inc
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notNestedInclude = function (exp, inc, msg) {
   new Assertion(exp, msg, assert.notNestedInclude, true)
     .not.nested.include(inc);
@@ -1084,13 +1033,12 @@ assert.notNestedInclude = function (exp, inc, msg) {
  *     assert.deepNestedInclude({'.a': {'[b]': {x: 1}}}, {'\\.a.\\[b\\]': {x: 1}});
  *
  * @name deepNestedInclude
- * @param {Object} haystack
- * @param {Object} needle
- * @param {String} message
+ * @param {object} exp
+ * @param {object} inc
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.deepNestedInclude = function(exp, inc, msg) {
   new Assertion(exp, msg, assert.deepNestedInclude, true)
     .deep.nested.include(inc);
@@ -1110,13 +1058,12 @@ assert.deepNestedInclude = function(exp, inc, msg) {
  *     assert.notDeepNestedInclude({'.a': {'[b]': {x: 1}}}, {'\\.a.\\[b\\]': {y: 2}});
  *
  * @name notDeepNestedInclude
- * @param {Object} haystack
- * @param {Object} needle
- * @param {String} message
+ * @param {object} exp
+ * @param {object} inc
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notDeepNestedInclude = function(exp, inc, msg) {
   new Assertion(exp, msg, assert.notDeepNestedInclude, true)
     .not.deep.nested.include(inc);
@@ -1132,13 +1079,12 @@ assert.notDeepNestedInclude = function(exp, inc, msg) {
  *     assert.ownInclude({ a: 1 }, { a: 1 });
  *
  * @name ownInclude
- * @param {Object} haystack
- * @param {Object} needle
- * @param {String} message
+ * @param {object} exp
+ * @param {object} inc
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.ownInclude = function(exp, inc, msg) {
   new Assertion(exp, msg, assert.ownInclude, true).own.include(inc);
 };
@@ -1146,22 +1092,20 @@ assert.ownInclude = function(exp, inc, msg) {
 /**
  * ### .notOwnInclude(haystack, needle, [message])
  *
- * Asserts that 'haystack' includes 'needle'.
+ * Asserts that 'haystack' does not include 'needle'.
  * Can be used to assert the absence of a subset of properties in an
  * object while ignoring inherited properties.
  *
  *     Object.prototype.b = 2;
- *
  *     assert.notOwnInclude({ a: 1 }, { b: 2 });
  *
  * @name notOwnInclude
- * @param {Object} haystack
- * @param {Object} needle
- * @param {String} message
+ * @param {object} exp
+ * @param {object} inc
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notOwnInclude = function(exp, inc, msg) {
   new Assertion(exp, msg, assert.notOwnInclude, true).not.own.include(inc);
 };
@@ -1173,38 +1117,36 @@ assert.notOwnInclude = function(exp, inc, msg) {
  * Can be used to assert the inclusion of a subset of properties in an
  * object while ignoring inherited properties and checking for deep equality.
  *
- *      assert.deepOwnInclude({a: {b: 2}}, {a: {b: 2}});
+ *     assert.deepOwnInclude({a: {b: 2}}, {a: {b: 2}});
  *
  * @name deepOwnInclude
- * @param {Object} haystack
- * @param {Object} needle
- * @param {String} message
+ * @param {object} exp
+ * @param {object} inc
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.deepOwnInclude = function(exp, inc, msg) {
   new Assertion(exp, msg, assert.deepOwnInclude, true)
     .deep.own.include(inc);
 };
 
- /**
+/**
  * ### .notDeepOwnInclude(haystack, needle, [message])
  *
  * Asserts that 'haystack' includes 'needle'.
  * Can be used to assert the absence of a subset of properties in an
  * object while ignoring inherited properties and checking for deep equality.
  *
- *      assert.notDeepOwnInclude({a: {b: 2}}, {a: {c: 3}});
+ *     assert.notDeepOwnInclude({a: {b: 2}}, {a: {c: 3}});
  *
  * @name notDeepOwnInclude
- * @param {Object} haystack
- * @param {Object} needle
- * @param {String} message
+ * @param {object} exp
+ * @param {object} inc
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notDeepOwnInclude = function(exp, inc, msg) {
   new Assertion(exp, msg, assert.notDeepOwnInclude, true)
     .not.deep.own.include(inc);
@@ -1218,13 +1160,12 @@ assert.notDeepOwnInclude = function(exp, inc, msg) {
  *     assert.match('foobar', /^foo/, 'regexp matches');
  *
  * @name match
- * @param {Mixed} value
- * @param {RegExp} regexp
- * @param {String} message
+ * @param {unknown} exp
+ * @param {RegExp} re
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.match = function (exp, re, msg) {
   new Assertion(exp, msg, assert.match, true).to.match(re);
 };
@@ -1237,13 +1178,12 @@ assert.match = function (exp, re, msg) {
  *     assert.notMatch('foobar', /^foo/, 'regexp does not match');
  *
  * @name notMatch
- * @param {Mixed} value
- * @param {RegExp} regexp
- * @param {String} message
+ * @param {unknown} exp
+ * @param {RegExp} re
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notMatch = function (exp, re, msg) {
   new Assertion(exp, msg, assert.notMatch, true).to.not.match(re);
 };
@@ -1258,13 +1198,12 @@ assert.notMatch = function (exp, re, msg) {
  *     assert.property({ tea: { green: 'matcha' }}, 'toString');
  *
  * @name property
- * @param {Object} object
- * @param {String} property
- * @param {String} message
+ * @param {object} obj
+ * @param {string} prop
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.property = function (obj, prop, msg) {
   new Assertion(obj, msg, assert.property, true).to.have.property(prop);
 };
@@ -1278,13 +1217,12 @@ assert.property = function (obj, prop, msg) {
  *     assert.notProperty({ tea: { green: 'matcha' }}, 'coffee');
  *
  * @name notProperty
- * @param {Object} object
- * @param {String} property
- * @param {String} message
+ * @param {object} obj
+ * @param {string} prop
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notProperty = function (obj, prop, msg) {
   new Assertion(obj, msg, assert.notProperty, true)
     .to.not.have.property(prop);
@@ -1300,14 +1238,13 @@ assert.notProperty = function (obj, prop, msg) {
  *     assert.propertyVal({ tea: 'is good' }, 'tea', 'is good');
  *
  * @name propertyVal
- * @param {Object} object
- * @param {String} property
- * @param {Mixed} value
- * @param {String} message
+ * @param {object} obj
+ * @param {string} prop
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.propertyVal = function (obj, prop, val, msg) {
   new Assertion(obj, msg, assert.propertyVal, true)
     .to.have.property(prop, val);
@@ -1324,14 +1261,13 @@ assert.propertyVal = function (obj, prop, val, msg) {
  *     assert.notPropertyVal({ tea: 'is good' }, 'coffee', 'is good');
  *
  * @name notPropertyVal
- * @param {Object} object
- * @param {String} property
- * @param {Mixed} value
- * @param {String} message
+ * @param {object} obj
+ * @param {string} prop
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notPropertyVal = function (obj, prop, val, msg) {
   new Assertion(obj, msg, assert.notPropertyVal, true)
     .to.not.have.property(prop, val);
@@ -1346,14 +1282,13 @@ assert.notPropertyVal = function (obj, prop, val, msg) {
  *     assert.deepPropertyVal({ tea: { green: 'matcha' } }, 'tea', { green: 'matcha' });
  *
  * @name deepPropertyVal
- * @param {Object} object
- * @param {String} property
- * @param {Mixed} value
- * @param {String} message
+ * @param {object} obj
+ * @param {string} prop
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.deepPropertyVal = function (obj, prop, val, msg) {
   new Assertion(obj, msg, assert.deepPropertyVal, true)
     .to.have.deep.property(prop, val);
@@ -1370,14 +1305,13 @@ assert.deepPropertyVal = function (obj, prop, val, msg) {
  *     assert.notDeepPropertyVal({ tea: { green: 'matcha' } }, 'coffee', { green: 'matcha' });
  *
  * @name notDeepPropertyVal
- * @param {Object} object
- * @param {String} property
- * @param {Mixed} value
- * @param {String} message
+ * @param {object} obj
+ * @param {string} prop
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notDeepPropertyVal = function (obj, prop, val, msg) {
   new Assertion(obj, msg, assert.notDeepPropertyVal, true)
     .to.not.have.deep.property(prop, val);
@@ -1392,12 +1326,11 @@ assert.notDeepPropertyVal = function (obj, prop, val, msg) {
  *     assert.ownProperty({ tea: { green: 'matcha' }}, 'tea');
  *
  * @name ownProperty
- * @param {Object} object
- * @param {String} property
- * @param {String} message
- * @api public
+ * @param {object} obj
+ * @param {string} prop
+ * @param {string} msg
+ * @public
  */
-
 assert.ownProperty = function (obj, prop, msg) {
   new Assertion(obj, msg, assert.ownProperty, true)
     .to.have.own.property(prop);
@@ -1413,12 +1346,11 @@ assert.ownProperty = function (obj, prop, msg) {
  *     assert.notOwnProperty({}, 'toString');
  *
  * @name notOwnProperty
- * @param {Object} object
- * @param {String} property
- * @param {String} message
- * @api public
+ * @param {object} obj
+ * @param {string} prop
+ * @param {string} msg
+ * @public
  */
-
 assert.notOwnProperty = function (obj, prop, msg) {
   new Assertion(obj, msg, assert.notOwnProperty, true)
     .to.not.have.own.property(prop);
@@ -1434,13 +1366,12 @@ assert.notOwnProperty = function (obj, prop, msg) {
  *     assert.ownPropertyVal({ coffee: 'is good'}, 'coffee', 'is good');
  *
  * @name ownPropertyVal
- * @param {Object} object
- * @param {String} property
- * @param {Mixed} value
- * @param {String} message
- * @api public
+ * @param {object} obj
+ * @param {string} prop
+ * @param {unknown} value
+ * @param {string} msg
+ * @public
  */
-
 assert.ownPropertyVal = function (obj, prop, value, msg) {
   new Assertion(obj, msg, assert.ownPropertyVal, true)
     .to.have.own.property(prop, value);
@@ -1457,13 +1388,12 @@ assert.ownPropertyVal = function (obj, prop, value, msg) {
  *     assert.notOwnPropertyVal({}, 'toString', Object.prototype.toString);
  *
  * @name notOwnPropertyVal
- * @param {Object} object
- * @param {String} property
- * @param {Mixed} value
- * @param {String} message
- * @api public
+ * @param {object} obj
+ * @param {string} prop
+ * @param {unknown} value
+ * @param {string} msg
+ * @public
  */
-
 assert.notOwnPropertyVal = function (obj, prop, value, msg) {
   new Assertion(obj, msg, assert.notOwnPropertyVal, true)
     .to.not.have.own.property(prop, value);
@@ -1479,13 +1409,12 @@ assert.notOwnPropertyVal = function (obj, prop, value, msg) {
  *     assert.deepOwnPropertyVal({ tea: { green: 'matcha' } }, 'tea', { green: 'matcha' });
  *
  * @name deepOwnPropertyVal
- * @param {Object} object
- * @param {String} property
- * @param {Mixed} value
- * @param {String} message
- * @api public
+ * @param {object} obj
+ * @param {string} prop
+ * @param {unknown} value
+ * @param {string} msg
+ * @public
  */
-
 assert.deepOwnPropertyVal = function (obj, prop, value, msg) {
   new Assertion(obj, msg, assert.deepOwnPropertyVal, true)
     .to.have.deep.own.property(prop, value);
@@ -1504,13 +1433,12 @@ assert.deepOwnPropertyVal = function (obj, prop, value, msg) {
  *     assert.notDeepOwnPropertyVal({}, 'toString', Object.prototype.toString);
  *
  * @name notDeepOwnPropertyVal
- * @param {Object} object
- * @param {String} property
- * @param {Mixed} value
- * @param {String} message
- * @api public
+ * @param {object} obj
+ * @param {string} prop
+ * @param {unknown} value
+ * @param {string} msg
+ * @public
  */
-
 assert.notDeepOwnPropertyVal = function (obj, prop, value, msg) {
   new Assertion(obj, msg, assert.notDeepOwnPropertyVal, true)
     .to.not.have.deep.own.property(prop, value);
@@ -1526,13 +1454,12 @@ assert.notDeepOwnPropertyVal = function (obj, prop, value, msg) {
  *     assert.nestedProperty({ tea: { green: 'matcha' }}, 'tea.green');
  *
  * @name nestedProperty
- * @param {Object} object
- * @param {String} property
- * @param {String} message
+ * @param {object} obj
+ * @param {string} prop
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.nestedProperty = function (obj, prop, msg) {
   new Assertion(obj, msg, assert.nestedProperty, true)
     .to.have.nested.property(prop);
@@ -1548,13 +1475,12 @@ assert.nestedProperty = function (obj, prop, msg) {
  *     assert.notNestedProperty({ tea: { green: 'matcha' }}, 'tea.oolong');
  *
  * @name notNestedProperty
- * @param {Object} object
- * @param {String} property
- * @param {String} message
+ * @param {object} obj
+ * @param {string} prop
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notNestedProperty = function (obj, prop, msg) {
   new Assertion(obj, msg, assert.notNestedProperty, true)
     .to.not.have.nested.property(prop);
@@ -1570,14 +1496,13 @@ assert.notNestedProperty = function (obj, prop, msg) {
  *     assert.nestedPropertyVal({ tea: { green: 'matcha' }}, 'tea.green', 'matcha');
  *
  * @name nestedPropertyVal
- * @param {Object} object
- * @param {String} property
- * @param {Mixed} value
- * @param {String} message
+ * @param {object} obj
+ * @param {string} prop
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.nestedPropertyVal = function (obj, prop, val, msg) {
   new Assertion(obj, msg, assert.nestedPropertyVal, true)
     .to.have.nested.property(prop, val);
@@ -1594,14 +1519,13 @@ assert.nestedPropertyVal = function (obj, prop, val, msg) {
  *     assert.notNestedPropertyVal({ tea: { green: 'matcha' }}, 'coffee.green', 'matcha');
  *
  * @name notNestedPropertyVal
- * @param {Object} object
- * @param {String} property
- * @param {Mixed} value
- * @param {String} message
+ * @param {object} obj
+ * @param {string} prop
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notNestedPropertyVal = function (obj, prop, val, msg) {
   new Assertion(obj, msg, assert.notNestedPropertyVal, true)
     .to.not.have.nested.property(prop, val);
@@ -1617,14 +1541,13 @@ assert.notNestedPropertyVal = function (obj, prop, val, msg) {
  *     assert.deepNestedPropertyVal({ tea: { green: { matcha: 'yum' } } }, 'tea.green', { matcha: 'yum' });
  *
  * @name deepNestedPropertyVal
- * @param {Object} object
- * @param {String} property
- * @param {Mixed} value
- * @param {String} message
+ * @param {object} obj
+ * @param {string} prop
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.deepNestedPropertyVal = function (obj, prop, val, msg) {
   new Assertion(obj, msg, assert.deepNestedPropertyVal, true)
     .to.have.deep.nested.property(prop, val);
@@ -1642,14 +1565,13 @@ assert.deepNestedPropertyVal = function (obj, prop, val, msg) {
  *     assert.notDeepNestedPropertyVal({ tea: { green: { matcha: 'yum' } } }, 'tea.black', { matcha: 'yum' });
  *
  * @name notDeepNestedPropertyVal
- * @param {Object} object
- * @param {String} property
- * @param {Mixed} value
- * @param {String} message
+ * @param {object} obj
+ * @param {string} prop
+ * @param {unknown} val
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notDeepNestedPropertyVal = function (obj, prop, val, msg) {
   new Assertion(obj, msg, assert.notDeepNestedPropertyVal, true)
     .to.not.have.deep.nested.property(prop, val);
@@ -1666,13 +1588,12 @@ assert.notDeepNestedPropertyVal = function (obj, prop, val, msg) {
  *     assert.lengthOf(new Map([['a',1],['b',2],['c',3]]), 3, 'map has size of 3');
  *
  * @name lengthOf
- * @param {Mixed} object
- * @param {Number} length
- * @param {String} message
+ * @param {unknown} exp
+ * @param {number} len
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.lengthOf = function (exp, len, msg) {
   new Assertion(exp, msg, assert.lengthOf, true).to.have.lengthOf(len);
 };
@@ -1690,13 +1611,12 @@ assert.lengthOf = function (exp, len, msg) {
  *     assert.hasAnyKeys(new Set([{foo: 'bar'}, 'anotherKey']), [{foo: 'bar'}, 'anotherKey']);
  *
  * @name hasAnyKeys
- * @param {Mixed} object
- * @param {Array|Object} keys
- * @param {String} message
+ * @param {unknown} obj
+ * @param {Array | object} keys
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.hasAnyKeys = function (obj, keys, msg) {
   new Assertion(obj, msg, assert.hasAnyKeys, true).to.have.any.keys(keys);
 }
@@ -1711,16 +1631,15 @@ assert.hasAnyKeys = function (obj, keys, msg) {
  *     assert.hasAllKeys({foo: 1, bar: 2, baz: 3}, ['foo', 'bar', 'baz']);
  *     assert.hasAllKeys({foo: 1, bar: 2, baz: 3}, {foo: 30, bar: 99, baz: 1337]);
  *     assert.hasAllKeys(new Map([[{foo: 1}, 'bar'], ['key', 'value']]), [{foo: 1}, 'key']);
- *     assert.hasAllKeys(new Set([{foo: 'bar'}, 'anotherKey'], [{foo: 'bar'}, 'anotherKey']);
+ *     assert.hasAllKeys(new Set([{foo: 'bar'}, 'anotherKey']), [{foo: 'bar'}, 'anotherKey']);
  *
  * @name hasAllKeys
- * @param {Mixed} object
- * @param {String[]} keys
- * @param {String} message
+ * @param {unknown} obj
+ * @param {string[]} keys
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.hasAllKeys = function (obj, keys, msg) {
   new Assertion(obj, msg, assert.hasAllKeys, true).to.have.all.keys(keys);
 }
@@ -1738,17 +1657,16 @@ assert.hasAllKeys = function (obj, keys, msg) {
  *     assert.containsAllKeys({foo: 1, bar: 2, baz: 3}, {foo: 30, bar: 99, baz: 1337});
  *     assert.containsAllKeys(new Map([[{foo: 1}, 'bar'], ['key', 'value']]), [{foo: 1}]);
  *     assert.containsAllKeys(new Map([[{foo: 1}, 'bar'], ['key', 'value']]), [{foo: 1}, 'key']);
- *     assert.containsAllKeys(new Set([{foo: 'bar'}, 'anotherKey'], [{foo: 'bar'}]);
- *     assert.containsAllKeys(new Set([{foo: 'bar'}, 'anotherKey'], [{foo: 'bar'}, 'anotherKey']);
+ *     assert.containsAllKeys(new Set([{foo: 'bar'}, 'anotherKey']), [{foo: 'bar'}]);
+ *     assert.containsAllKeys(new Set([{foo: 'bar'}, 'anotherKey']), [{foo: 'bar'}, 'anotherKey']);
  *
  * @name containsAllKeys
- * @param {Mixed} object
- * @param {String[]} keys
- * @param {String} message
+ * @param {unknown} obj
+ * @param {string[]} keys
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.containsAllKeys = function (obj, keys, msg) {
   new Assertion(obj, msg, assert.containsAllKeys, true)
     .to.contain.all.keys(keys);
@@ -1764,16 +1682,15 @@ assert.containsAllKeys = function (obj, keys, msg) {
  *     assert.doesNotHaveAnyKeys({foo: 1, bar: 2, baz: 3}, ['one', 'two', 'example']);
  *     assert.doesNotHaveAnyKeys({foo: 1, bar: 2, baz: 3}, {one: 1, two: 2, example: 'foo'});
  *     assert.doesNotHaveAnyKeys(new Map([[{foo: 1}, 'bar'], ['key', 'value']]), [{one: 'two'}, 'example']);
- *     assert.doesNotHaveAnyKeys(new Set([{foo: 'bar'}, 'anotherKey'], [{one: 'two'}, 'example']);
+ *     assert.doesNotHaveAnyKeys(new Set([{foo: 'bar'}, 'anotherKey']), [{one: 'two'}, 'example']);
  *
  * @name doesNotHaveAnyKeys
- * @param {Mixed} object
- * @param {String[]} keys
- * @param {String} message
+ * @param {unknown} obj
+ * @param {string[]} keys
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.doesNotHaveAnyKeys = function (obj, keys, msg) {
   new Assertion(obj, msg, assert.doesNotHaveAnyKeys, true)
     .to.not.have.any.keys(keys);
@@ -1789,16 +1706,15 @@ assert.doesNotHaveAnyKeys = function (obj, keys, msg) {
  *     assert.doesNotHaveAllKeys({foo: 1, bar: 2, baz: 3}, ['one', 'two', 'example']);
  *     assert.doesNotHaveAllKeys({foo: 1, bar: 2, baz: 3}, {one: 1, two: 2, example: 'foo'});
  *     assert.doesNotHaveAllKeys(new Map([[{foo: 1}, 'bar'], ['key', 'value']]), [{one: 'two'}, 'example']);
- *     assert.doesNotHaveAllKeys(new Set([{foo: 'bar'}, 'anotherKey'], [{one: 'two'}, 'example']);
+ *     assert.doesNotHaveAllKeys(new Set([{foo: 'bar'}, 'anotherKey']), [{one: 'two'}, 'example']);
  *
  * @name doesNotHaveAllKeys
- * @param {Mixed} object
- * @param {String[]} keys
- * @param {String} message
+ * @param {unknown} obj
+ * @param {string[]} keys
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.doesNotHaveAllKeys = function (obj, keys, msg) {
   new Assertion(obj, msg, assert.doesNotHaveAllKeys, true)
     .to.not.have.all.keys(keys);
@@ -1821,13 +1737,12 @@ assert.doesNotHaveAllKeys = function (obj, keys, msg) {
  *     assert.hasAnyDeepKeys(new Set([{one: 'one'}, {two: 'two'}]), [{one: 'one'}, {two: 'two'}]);
  *
  * @name hasAnyDeepKeys
- * @param {Mixed} object
- * @param {Array|Object} keys
- * @param {String} message
+ * @param {unknown} obj
+ * @param {Array | object} keys
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.hasAnyDeepKeys = function (obj, keys, msg) {
   new Assertion(obj, msg, assert.hasAnyDeepKeys, true)
     .to.have.any.deep.keys(keys);
@@ -1848,13 +1763,12 @@ assert.hasAnyDeepKeys = function (obj, keys, msg) {
  *     assert.hasAllDeepKeys(new Set([{one: 'one'}, {two: 'two'}]), [{one: 'one'}, {two: 'two'}]);
  *
  * @name hasAllDeepKeys
- * @param {Mixed} object
- * @param {Array|Object} keys
- * @param {String} message
+ * @param {unknown} obj
+ * @param {Array | object} keys
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.hasAllDeepKeys = function (obj, keys, msg) {
   new Assertion(obj, msg, assert.hasAllDeepKeys, true)
     .to.have.all.deep.keys(keys);
@@ -1875,13 +1789,12 @@ assert.hasAllDeepKeys = function (obj, keys, msg) {
  *     assert.containsAllDeepKeys(new Set([{one: 'one'}, {two: 'two'}]), [{one: 'one'}, {two: 'two'}]);
  *
  * @name containsAllDeepKeys
- * @param {Mixed} object
- * @param {Array|Object} keys
- * @param {String} message
+ * @param {unknown} obj
+ * @param {Array | object} keys
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.containsAllDeepKeys = function (obj, keys, msg) {
   new Assertion(obj, msg, assert.containsAllDeepKeys, true)
     .to.contain.all.deep.keys(keys);
@@ -1902,13 +1815,12 @@ assert.containsAllDeepKeys = function (obj, keys, msg) {
  *     assert.doesNotHaveAnyDeepKeys(new Set([{one: 'one'}, {two: 'two'}]), [{twenty: 'twenty'}, {fifty: 'fifty'}]);
  *
  * @name doesNotHaveAnyDeepKeys
- * @param {Mixed} object
- * @param {Array|Object} keys
- * @param {String} message
+ * @param {unknown} obj
+ * @param {Array | object} keys
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.doesNotHaveAnyDeepKeys = function (obj, keys, msg) {
   new Assertion(obj, msg, assert.doesNotHaveAnyDeepKeys, true)
     .to.not.have.any.deep.keys(keys);
@@ -1929,13 +1841,12 @@ assert.doesNotHaveAnyDeepKeys = function (obj, keys, msg) {
  *     assert.doesNotHaveAllDeepKeys(new Set([{one: 'one'}, {two: 'two'}]), [{one: 'one'}, {fifty: 'fifty'}]);
  *
  * @name doesNotHaveAllDeepKeys
- * @param {Mixed} object
- * @param {Array|Object} keys
- * @param {String} message
+ * @param {unknown} obj
+ * @param {Array | object} keys
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.doesNotHaveAllDeepKeys = function (obj, keys, msg) {
   new Assertion(obj, msg, assert.doesNotHaveAllDeepKeys, true)
     .to.not.have.all.deep.keys(keys);
@@ -1964,14 +1875,14 @@ assert.doesNotHaveAllDeepKeys = function (obj, keys, msg) {
  * @alias throw
  * @alias Throw
  * @param {Function} fn
- * @param {ErrorConstructor|Error} errorLike
- * @param {RegExp|String} errMsgMatcher
- * @param {String} message
+ * @param {Error} errorLike
+ * @param {RegExp | string} errMsgMatcher
+ * @param {string} msg
+ * @returns {unknown}
  * @see https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Error#Error_types
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.throws = function (fn, errorLike, errMsgMatcher, msg) {
   if ('string' === typeof errorLike || errorLike instanceof RegExp) {
     errMsgMatcher = errorLike;
@@ -2004,21 +1915,20 @@ assert.throws = function (fn, errorLike, errMsgMatcher, msg) {
  *
  * @name doesNotThrow
  * @param {Function} fn
- * @param {ErrorConstructor} errorLike
- * @param {RegExp|String} errMsgMatcher
- * @param {String} message
+ * @param {Error} errorLike
+ * @param {RegExp | string} errMsgMatcher
+ * @param {string} message
  * @see https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Error#Error_types
  * @namespace Assert
- * @api public
+ * @public
  */
-
-assert.doesNotThrow = function (fn, errorLike, errMsgMatcher, msg) {
+assert.doesNotThrow = function (fn, errorLike, errMsgMatcher, message) {
   if ('string' === typeof errorLike || errorLike instanceof RegExp) {
     errMsgMatcher = errorLike;
     errorLike = null;
   }
 
-  new Assertion(fn, msg, assert.doesNotThrow, true)
+  new Assertion(fn, message, assert.doesNotThrow, true)
     .to.not.throw(errorLike, errMsgMatcher);
 };
 
@@ -2031,14 +1941,13 @@ assert.doesNotThrow = function (fn, errorLike, errMsgMatcher, msg) {
  *     assert.operator(1, '>', 2, 'this will fail');
  *
  * @name operator
- * @param {Mixed} val1
- * @param {String} operator
- * @param {Mixed} val2
- * @param {String} message
+ * @param {unknown} val
+ * @param {string} operator
+ * @param {unknown} val2
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.operator = function (val, operator, val2, msg) {
   var ok;
   switch(operator) {
@@ -2089,14 +1998,13 @@ assert.operator = function (val, operator, val2, msg) {
  *     assert.closeTo(1.5, 1, 0.5, 'numbers are close');
  *
  * @name closeTo
- * @param {Number} actual
- * @param {Number} expected
- * @param {Number} delta
- * @param {String} message
+ * @param {number} act
+ * @param {number} exp
+ * @param {number} delta
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.closeTo = function (act, exp, delta, msg) {
   new Assertion(act, msg, assert.closeTo, true).to.be.closeTo(exp, delta);
 };
@@ -2109,14 +2017,13 @@ assert.closeTo = function (act, exp, delta, msg) {
  *     assert.approximately(1.5, 1, 0.5, 'numbers are close');
  *
  * @name approximately
- * @param {Number} actual
- * @param {Number} expected
- * @param {Number} delta
- * @param {String} message
+ * @param {number} act
+ * @param {number} exp
+ * @param {number} delta
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.approximately = function (act, exp, delta, msg) {
   new Assertion(act, msg, assert.approximately, true)
     .to.be.approximately(exp, delta);
@@ -2133,11 +2040,10 @@ assert.approximately = function (act, exp, delta, msg) {
  * @name sameMembers
  * @param {Array} set1
  * @param {Array} set2
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.sameMembers = function (set1, set2, msg) {
   new Assertion(set1, msg, assert.sameMembers, true)
     .to.have.same.members(set2);
@@ -2154,11 +2060,10 @@ assert.sameMembers = function (set1, set2, msg) {
  * @name notSameMembers
  * @param {Array} set1
  * @param {Array} set2
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notSameMembers = function (set1, set2, msg) {
   new Assertion(set1, msg, assert.notSameMembers, true)
     .to.not.have.same.members(set2);
@@ -2175,11 +2080,10 @@ assert.notSameMembers = function (set1, set2, msg) {
  * @name sameDeepMembers
  * @param {Array} set1
  * @param {Array} set2
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.sameDeepMembers = function (set1, set2, msg) {
   new Assertion(set1, msg, assert.sameDeepMembers, true)
     .to.have.same.deep.members(set2);
@@ -2196,11 +2100,10 @@ assert.sameDeepMembers = function (set1, set2, msg) {
  * @name notSameDeepMembers
  * @param {Array} set1
  * @param {Array} set2
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notSameDeepMembers = function (set1, set2, msg) {
   new Assertion(set1, msg, assert.notSameDeepMembers, true)
     .to.not.have.same.deep.members(set2);
@@ -2217,11 +2120,10 @@ assert.notSameDeepMembers = function (set1, set2, msg) {
  * @name sameOrderedMembers
  * @param {Array} set1
  * @param {Array} set2
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.sameOrderedMembers = function (set1, set2, msg) {
   new Assertion(set1, msg, assert.sameOrderedMembers, true)
     .to.have.same.ordered.members(set2);
@@ -2238,11 +2140,10 @@ assert.sameOrderedMembers = function (set1, set2, msg) {
  * @name notSameOrderedMembers
  * @param {Array} set1
  * @param {Array} set2
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notSameOrderedMembers = function (set1, set2, msg) {
   new Assertion(set1, msg, assert.notSameOrderedMembers, true)
     .to.not.have.same.ordered.members(set2);
@@ -2259,11 +2160,10 @@ assert.notSameOrderedMembers = function (set1, set2, msg) {
  * @name sameDeepOrderedMembers
  * @param {Array} set1
  * @param {Array} set2
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.sameDeepOrderedMembers = function (set1, set2, msg) {
   new Assertion(set1, msg, assert.sameDeepOrderedMembers, true)
     .to.have.same.deep.ordered.members(set2);
@@ -2281,11 +2181,10 @@ assert.sameDeepOrderedMembers = function (set1, set2, msg) {
  * @name notSameDeepOrderedMembers
  * @param {Array} set1
  * @param {Array} set2
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notSameDeepOrderedMembers = function (set1, set2, msg) {
   new Assertion(set1, msg, assert.notSameDeepOrderedMembers, true)
     .to.not.have.same.deep.ordered.members(set2);
@@ -2302,11 +2201,10 @@ assert.notSameDeepOrderedMembers = function (set1, set2, msg) {
  * @name includeMembers
  * @param {Array} superset
  * @param {Array} subset
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.includeMembers = function (superset, subset, msg) {
   new Assertion(superset, msg, assert.includeMembers, true)
     .to.include.members(subset);
@@ -2323,11 +2221,10 @@ assert.includeMembers = function (superset, subset, msg) {
  * @name notIncludeMembers
  * @param {Array} superset
  * @param {Array} subset
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notIncludeMembers = function (superset, subset, msg) {
   new Assertion(superset, msg, assert.notIncludeMembers, true)
     .to.not.include.members(subset);
@@ -2344,11 +2241,10 @@ assert.notIncludeMembers = function (superset, subset, msg) {
  * @name includeDeepMembers
  * @param {Array} superset
  * @param {Array} subset
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.includeDeepMembers = function (superset, subset, msg) {
   new Assertion(superset, msg, assert.includeDeepMembers, true)
     .to.include.deep.members(subset);
@@ -2365,11 +2261,10 @@ assert.includeDeepMembers = function (superset, subset, msg) {
  * @name notIncludeDeepMembers
  * @param {Array} superset
  * @param {Array} subset
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notIncludeDeepMembers = function (superset, subset, msg) {
   new Assertion(superset, msg, assert.notIncludeDeepMembers, true)
     .to.not.include.deep.members(subset);
@@ -2387,11 +2282,10 @@ assert.notIncludeDeepMembers = function (superset, subset, msg) {
  * @name includeOrderedMembers
  * @param {Array} superset
  * @param {Array} subset
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.includeOrderedMembers = function (superset, subset, msg) {
   new Assertion(superset, msg, assert.includeOrderedMembers, true)
     .to.include.ordered.members(subset);
@@ -2410,11 +2304,10 @@ assert.includeOrderedMembers = function (superset, subset, msg) {
  * @name notIncludeOrderedMembers
  * @param {Array} superset
  * @param {Array} subset
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notIncludeOrderedMembers = function (superset, subset, msg) {
   new Assertion(superset, msg, assert.notIncludeOrderedMembers, true)
     .to.not.include.ordered.members(subset);
@@ -2432,11 +2325,10 @@ assert.notIncludeOrderedMembers = function (superset, subset, msg) {
  * @name includeDeepOrderedMembers
  * @param {Array} superset
  * @param {Array} subset
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.includeDeepOrderedMembers = function (superset, subset, msg) {
   new Assertion(superset, msg, assert.includeDeepOrderedMembers, true)
     .to.include.deep.ordered.members(subset);
@@ -2456,11 +2348,10 @@ assert.includeDeepOrderedMembers = function (superset, subset, msg) {
  * @name notIncludeDeepOrderedMembers
  * @param {Array} superset
  * @param {Array} subset
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.notIncludeDeepOrderedMembers = function (superset, subset, msg) {
   new Assertion(superset, msg, assert.notIncludeDeepOrderedMembers, true)
     .to.not.include.deep.ordered.members(subset);
@@ -2476,15 +2367,41 @@ assert.notIncludeDeepOrderedMembers = function (superset, subset, msg) {
  * @name oneOf
  * @param {*} inList
  * @param {Array<*>} list
- * @param {String} message
+ * @param {string} msg
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.oneOf = function (inList, list, msg) {
   new Assertion(inList, msg, assert.oneOf, true).to.be.oneOf(list);
 }
 
+/**
+ * ### isIterable(obj, [message])
+ *
+ * Asserts that the target is an iterable, which means that it has a iterator
+ * with the exception of `String.`
+ *
+ *     assert.isIterable([1, 2]);
+ *
+ * @param {unknown} obj
+ * @param {string} [msg]
+ * @namespace Assert
+ * @public
+ */
+assert.isIterable = function(obj, msg) {
+  if (obj == undefined || !obj[Symbol.iterator]) {
+    msg = msg ?
+      `${msg} expected ${inspect(obj)} to be an iterable` :
+      `expected ${inspect(obj)} to be an iterable`;
+
+    throw new AssertionError(
+      msg,
+      undefined,
+      assert.isIterable
+    );
+  }
+}
+
 /**
  * ### .changes(function, object, property, [message])
  *
@@ -2495,14 +2412,13 @@ assert.oneOf = function (inList, list, msg) {
  *     assert.changes(fn, obj, 'val');
  *
  * @name changes
- * @param {Function} modifier function
- * @param {Object} object or getter function
- * @param {String} property name _optional_
- * @param {String} message _optional_
+ * @param {Function} fn modifier function
+ * @param {object} obj object or getter function
+ * @param {string} prop property name _optional_
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.changes = function (fn, obj, prop, msg) {
   if (arguments.length === 3 && typeof obj === 'function') {
     msg = prop;
@@ -2512,7 +2428,7 @@ assert.changes = function (fn, obj, prop, msg) {
   new Assertion(fn, msg, assert.changes, true).to.change(obj, prop);
 }
 
- /**
+/**
  * ### .changesBy(function, object, property, delta, [message])
  *
  * Asserts that a function changes the value of a property by an amount (delta).
@@ -2522,15 +2438,14 @@ assert.changes = function (fn, obj, prop, msg) {
  *     assert.changesBy(fn, obj, 'val', 2);
  *
  * @name changesBy
- * @param {Function} modifier function
- * @param {Object} object or getter function
- * @param {String} property name _optional_
- * @param {Number} change amount (delta)
- * @param {String} message _optional_
+ * @param {Function} fn modifier function
+ * @param {object} obj object or getter function
+ * @param {string} prop property name _optional_
+ * @param {number} delta msg change amount (delta)
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.changesBy = function (fn, obj, prop, delta, msg) {
   if (arguments.length === 4 && typeof obj === 'function') {
     var tmpMsg = delta;
@@ -2545,24 +2460,24 @@ assert.changesBy = function (fn, obj, prop, delta, msg) {
     .to.change(obj, prop).by(delta);
 }
 
- /**
+/**
  * ### .doesNotChange(function, object, property, [message])
  *
  * Asserts that a function does not change the value of a property.
  *
- *     var obj = { val: 10 };
- *     var fn = function() { console.log('foo'); };
- *     assert.doesNotChange(fn, obj, 'val');
+ *   var obj = { val: 10 };
+ *   var fn = function() { console.log('foo'); };
+ *   assert.doesNotChange(fn, obj, 'val');
  *
  * @name doesNotChange
- * @param {Function} modifier function
- * @param {Object} object or getter function
- * @param {String} property name _optional_
- * @param {String} message _optional_
+ * @param {Function} fn modifier function
+ * @param {object} obj object or getter function
+ * @param {string} prop property name _optional_
+ * @param {string} msg _optional_
+ * @returns {unknown}
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.doesNotChange = function (fn, obj, prop, msg) {
   if (arguments.length === 3 && typeof obj === 'function') {
     msg = prop;
@@ -2583,15 +2498,14 @@ assert.doesNotChange = function (fn, obj, prop, msg) {
  *     assert.changesButNotBy(fn, obj, 'val', 5);
  *
  * @name changesButNotBy
- * @param {Function} modifier function
- * @param {Object} object or getter function
- * @param {String} property name _optional_
- * @param {Number} change amount (delta)
- * @param {String} message _optional_
+ * @param {Function} fn - modifier function
+ * @param {object} obj - object or getter function
+ * @param {string} prop - property name _optional_
+ * @param {number} delta - change amount (delta)
+ * @param {string} msg - message _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.changesButNotBy = function (fn, obj, prop, delta, msg) {
   if (arguments.length === 4 && typeof obj === 'function') {
     var tmpMsg = delta;
@@ -2615,15 +2529,15 @@ assert.changesButNotBy = function (fn, obj, prop, delta, msg) {
  *     var fn = function() { obj.val = 13 };
  *     assert.increases(fn, obj, 'val');
  *
- * @name increases
- * @param {Function} modifier function
- * @param {Object} object or getter function
- * @param {String} property name _optional_
- * @param {String} message _optional_
+ * @public
  * @namespace Assert
- * @api public
+ * @name increases
+ * @param {Function} fn - modifier function
+ * @param {object} obj - object or getter function
+ * @param {string} prop - property name _optional_
+ * @param {string} msg - message _optional_
+ * @returns {unknown}
  */
-
 assert.increases = function (fn, obj, prop, msg) {
   if (arguments.length === 3 && typeof obj === 'function') {
     msg = prop;
@@ -2643,16 +2557,15 @@ assert.increases = function (fn, obj, prop, msg) {
  *     var fn = function() { obj.val += 10 };
  *     assert.increasesBy(fn, obj, 'val', 10);
  *
+ * @public
  * @name increasesBy
- * @param {Function} modifier function
- * @param {Object} object or getter function
- * @param {String} property name _optional_
- * @param {Number} change amount (delta)
- * @param {String} message _optional_
  * @namespace Assert
- * @api public
+ * @param {Function} fn - modifier function
+ * @param {object} obj - object or getter function
+ * @param {string} prop - property name _optional_
+ * @param {number} delta - change amount (delta)
+ * @param {string} msg - message _optional_
  */
-
 assert.increasesBy = function (fn, obj, prop, delta, msg) {
   if (arguments.length === 4 && typeof obj === 'function') {
     var tmpMsg = delta;
@@ -2677,14 +2590,14 @@ assert.increasesBy = function (fn, obj, prop, delta, msg) {
  *     assert.doesNotIncrease(fn, obj, 'val');
  *
  * @name doesNotIncrease
- * @param {Function} modifier function
- * @param {Object} object or getter function
- * @param {String} property name _optional_
- * @param {String} message _optional_
+ * @param {Function} fn modifier function
+ * @param {object} obj object or getter function
+ * @param {string} prop property name _optional_
+ * @returns {Assertion}
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.doesNotIncrease = function (fn, obj, prop, msg) {
   if (arguments.length === 3 && typeof obj === 'function') {
     msg = prop;
@@ -2705,15 +2618,14 @@ assert.doesNotIncrease = function (fn, obj, prop, msg) {
  *     assert.increasesButNotBy(fn, obj, 'val', 10);
  *
  * @name increasesButNotBy
- * @param {Function} modifier function
- * @param {Object} object or getter function
- * @param {String} property name _optional_
- * @param {Number} change amount (delta)
- * @param {String} message _optional_
+ * @param {Function} fn modifier function
+ * @param {object} obj object or getter function
+ * @param {string} prop property name _optional_
+ * @param {number} delta change amount (delta)
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.increasesButNotBy = function (fn, obj, prop, delta, msg) {
   if (arguments.length === 4 && typeof obj === 'function') {
     var tmpMsg = delta;
@@ -2738,14 +2650,14 @@ assert.increasesButNotBy = function (fn, obj, prop, delta, msg) {
  *     assert.decreases(fn, obj, 'val');
  *
  * @name decreases
- * @param {Function} modifier function
- * @param {Object} object or getter function
- * @param {String} property name _optional_
- * @param {String} message _optional_
+ * @param {Function} fn modifier function
+ * @param {object} obj object or getter function
+ * @param {string} prop property name _optional_
+ * @returns {Assertion}
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.decreases = function (fn, obj, prop, msg) {
   if (arguments.length === 3 && typeof obj === 'function') {
     msg = prop;
@@ -2766,15 +2678,14 @@ assert.decreases = function (fn, obj, prop, msg) {
  *     assert.decreasesBy(fn, obj, 'val', 5);
  *
  * @name decreasesBy
- * @param {Function} modifier function
- * @param {Object} object or getter function
- * @param {String} property name _optional_
- * @param {Number} change amount (delta)
- * @param {String} message _optional_
+ * @param {Function} fn modifier function
+ * @param {object} obj object or getter function
+ * @param {string} prop property name _optional_
+ * @param {number} delta change amount (delta)
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.decreasesBy = function (fn, obj, prop, delta, msg) {
   if (arguments.length === 4 && typeof obj === 'function') {
     var tmpMsg = delta;
@@ -2799,14 +2710,14 @@ assert.decreasesBy = function (fn, obj, prop, delta, msg) {
  *     assert.doesNotDecrease(fn, obj, 'val');
  *
  * @name doesNotDecrease
- * @param {Function} modifier function
- * @param {Object} object or getter function
- * @param {String} property name _optional_
- * @param {String} message _optional_
+ * @param {Function} fn modifier function
+ * @param {object} obj object or getter function
+ * @param {string} prop property name _optional_
+ * @returns {Assertion}
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.doesNotDecrease = function (fn, obj, prop, msg) {
   if (arguments.length === 3 && typeof obj === 'function') {
     msg = prop;
@@ -2827,15 +2738,15 @@ assert.doesNotDecrease = function (fn, obj, prop, msg) {
  *     assert.doesNotDecreaseBy(fn, obj, 'val', 1);
  *
  * @name doesNotDecreaseBy
- * @param {Function} modifier function
- * @param {Object} object or getter function
- * @param {String} property name _optional_
- * @param {Number} change amount (delta)
- * @param {String} message _optional_
+ * @param {Function} fn modifier function
+ * @param {object} obj object or getter function
+ * @param {string} prop property name _optional_
+ * @param {number} delta change amount (delta)
+ * @returns {Assertion}
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.doesNotDecreaseBy = function (fn, obj, prop, delta, msg) {
   if (arguments.length === 4 && typeof obj === 'function') {
     var tmpMsg = delta;
@@ -2860,15 +2771,14 @@ assert.doesNotDecreaseBy = function (fn, obj, prop, delta, msg) {
  *     assert.decreasesButNotBy(fn, obj, 'val', 1);
  *
  * @name decreasesButNotBy
- * @param {Function} modifier function
- * @param {Object} object or getter function
- * @param {String} property name _optional_
- * @param {Number} change amount (delta)
- * @param {String} message _optional_
+ * @param {Function} fn modifier function
+ * @param {object} obj object or getter function
+ * @param {string} prop property name _optional_
+ * @param {number} delta change amount (delta)
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.decreasesButNotBy = function (fn, obj, prop, delta, msg) {
   if (arguments.length === 4 && typeof obj === 'function') {
     var tmpMsg = delta;
@@ -2883,7 +2793,7 @@ assert.decreasesButNotBy = function (fn, obj, prop, delta, msg) {
     .to.decrease(obj, prop).but.not.by(delta);
 }
 
-/*!
+/**
  * ### .ifError(object)
  *
  * Asserts if value is not a false value, and throws if it is a true value.
@@ -2894,11 +2804,10 @@ assert.decreasesButNotBy = function (fn, obj, prop, delta, msg) {
  *     assert.ifError(err); // Rethrows err!
  *
  * @name ifError
- * @param {Object} object
+ * @param {object} val
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.ifError = function (val) {
   if (val) {
     throw(val);
@@ -2914,12 +2823,11 @@ assert.ifError = function (val) {
  *
  * @name isExtensible
  * @alias extensible
- * @param {Object} object
- * @param {String} message _optional_
+ * @param {object} obj
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isExtensible = function (obj, msg) {
   new Assertion(obj, msg, assert.isExtensible, true).to.be.extensible;
 };
@@ -2939,12 +2847,11 @@ assert.isExtensible = function (obj, msg) {
  *
  * @name isNotExtensible
  * @alias notExtensible
- * @param {Object} object
- * @param {String} message _optional_
+ * @param {object} obj
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isNotExtensible = function (obj, msg) {
   new Assertion(obj, msg, assert.isNotExtensible, true).to.not.be.extensible;
 };
@@ -2963,12 +2870,11 @@ assert.isNotExtensible = function (obj, msg) {
  *
  * @name isSealed
  * @alias sealed
- * @param {Object} object
- * @param {String} message _optional_
+ * @param {object} obj
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isSealed = function (obj, msg) {
   new Assertion(obj, msg, assert.isSealed, true).to.be.sealed;
 };
@@ -2982,12 +2888,11 @@ assert.isSealed = function (obj, msg) {
  *
  * @name isNotSealed
  * @alias notSealed
- * @param {Object} object
- * @param {String} message _optional_
+ * @param {object} obj
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isNotSealed = function (obj, msg) {
   new Assertion(obj, msg, assert.isNotSealed, true).to.not.be.sealed;
 };
@@ -3003,12 +2908,11 @@ assert.isNotSealed = function (obj, msg) {
  *
  * @name isFrozen
  * @alias frozen
- * @param {Object} object
- * @param {String} message _optional_
+ * @param {object} obj
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isFrozen = function (obj, msg) {
   new Assertion(obj, msg, assert.isFrozen, true).to.be.frozen;
 };
@@ -3022,12 +2926,11 @@ assert.isFrozen = function (obj, msg) {
  *
  * @name isNotFrozen
  * @alias notFrozen
- * @param {Object} object
- * @param {String} message _optional_
+ * @param {object} obj
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isNotFrozen = function (obj, msg) {
   new Assertion(obj, msg, assert.isNotFrozen, true).to.not.be.frozen;
 };
@@ -3048,12 +2951,11 @@ assert.isNotFrozen = function (obj, msg) {
  *
  * @name isEmpty
  * @alias empty
- * @param {Object|Array|String|Map|Set} target
- * @param {String} message _optional_
+ * @param {object | Array | string | Map | Set} val
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isEmpty = function(val, msg) {
   new Assertion(val, msg, assert.isEmpty, true).to.be.empty;
 };
@@ -3074,20 +2976,22 @@ assert.isEmpty = function(val, msg) {
  *
  * @name isNotEmpty
  * @alias notEmpty
- * @param {Object|Array|String|Map|Set} target
- * @param {String} message _optional_
+ * @param {object | Array | string | Map | Set} val
+ * @param {string} msg _optional_
  * @namespace Assert
- * @api public
+ * @public
  */
-
 assert.isNotEmpty = function(val, msg) {
   new Assertion(val, msg, assert.isNotEmpty, true).to.not.be.empty;
 };
 
-/*!
+/**
  * Aliases.
+ *
+ * @param {unknown} name
+ * @param {unknown} as
+ * @returns {unknown}
  */
-
 (function alias(name, as){
   assert[as] = assert[name];
   return alias;