t.has() and t.match() are not synonyms, they're different

isaacs · isaacs · commit 2c15bd87796d · 2021-02-16T17:57:21.000-08:00
Also, add docs for t.notHas and t.notHasStrict
diff --git a/docs/src/content/docs/api/asserts/index.md b/docs/src/content/docs/api/asserts/index.md
@@ -256,8 +256,30 @@ undefined` in the pattern to ensure that a field is not defined in the
 found object, but it will not differentiate between a missing property and
 a property set to `undefined`.
 
-Note that `t.has()`, the un-strict version of this function, is an alias
-for `t.match()`.
+## t.notHasStrict(found, pattern, messsage, extra)
+
+The inverse of `t.hasStrict()`.  Verifies that the found object does not
+contain all of the provided fields, or if it does, that they are not the
+same values and/or types.
+
+## t.has(found, pattern, message, extra)
+
+Verify that the found object contains all of the provided fields, and that
+they coerce to the same values, even if the types do not match.
+
+This does _not_ do advanced/loose matching based on constructor, regexp
+patterns, and so on, like `t.match()` does.  You _may_ specify `key:
+undefined` in the pattern to ensure that a field is not defined in the
+found object, but it will not differentiate between a missing property and
+a property set to `undefined`.
+
+Synonyms: `t.hasFields`, `t.includes`, `t.include`, `t.contains`
+
+## t.notHas(found, pattern, message, extra)
+
+The inverse of `t.has()`.  Verifies that the found object does not contain
+all of the provided fields, or if it does, that they do not coerce to the
+same values.
 
 ## t.match(found, pattern, message, extra)
 
@@ -280,8 +302,7 @@ set of required fields, but additional fields are ok.
 See [tcompare](http://npm.im/tcompare) for the full details on how this
 works.
 
-Synonyms: `t.has`, `t.hasFields`, `t.matches`, `t.similar`, `t.like`,
-`t.isLike`, `t.includes`, `t.include`, `t.contains`
+Synonyms: `t.matches`, `t.similar`, `t.like`, `t.isLike`
 
 ## t.notMatch(found, pattern, message, extra)
 
diff --git a/lib/synonyms.js b/lib/synonyms.js
@@ -64,8 +64,11 @@ module.exports = multiword({
 
   // found has the fields in wanted, string matches regexp
   match: [
-    'has', 'hasFields', 'matches', 'similar', 'like', 'isLike',
-    'includes', 'include', 'isSimilar', 'contains'
+    'matches', 'similar', 'like', 'isLike', 'isSimilar'
+  ],
+
+  has: [
+    'hasFields', 'includes', 'include', 'contains'
   ],
 
   notMatch: [
