Add improved docs

Author: wooorm

lib/index.js

@@ -10,15 +10,18 @@
 const own = {}.hasOwnProperty
 
 /**
- * Check if `node` has a `field` property.
+ * Check if `node`is an element and has a `field` property.
  *
  * @param {unknown} node
- * @param {string | null | undefined} field
+ *   Thing to check (typically `Element`).
+ * @param {unknown} field
+ *   Field name to check (typically `string`).
  * @returns {boolean}
+ *   Whether `node` is an element that has a `field` property.
  */
 export function hasProperty(node, field) {
   const value =
-    field &&
+    typeof field === 'string' &&
     isNode(node) &&
     node.type === 'element' &&
     node.properties &&

readme.md

@@ -17,7 +17,7 @@
 *   [Install](#install)
 *   [Use](#use)
 *   [API](#api)
-    *   [`hasProperty(node, name)`](#haspropertynode-name)
+    *   [`hasProperty(node, field)`](#haspropertynode-field)
 *   [Types](#types)
 *   [Compatibility](#compatibility)
 *   [Security](#security)
@@ -38,7 +38,7 @@ looking for!
 ## Install
 
 This package is [ESM only][esm].
-In Node.js (version 12.20+, 14.14+, 16.0+, or 18.0+), install with [npm][]:
+In Node.js (version 14.14+ and 16.0+), install with [npm][]:
 
 ```sh
 npm install hast-util-has-property
@@ -88,22 +88,21 @@ hasProperty(
 
 ## API
 
-This package exports the identifier `hasProperty`.
+This package exports the identifier [`hasProperty`][hasproperty].
 There is no default export.
 
-### `hasProperty(node, name)`
+### `hasProperty(node, field)`
 
-Check if `node` is an [*element*][element] that has a `name`
-[*property name*][property].
+Check if `node`is an element and has a `field` property.
 
 ###### Parameters
 
-*   `node` ([`Node`][node], optional) — [*Node*][node] to check, likely element
-*   `name` (`string`) - [*Property name*][property]
+*   `node` (`unknown`) — thing to check (typically [`Element`][element])
+*   `name` (`unknown`) - field name to check (typically `string`)
 
 ###### Returns
 
-Whether `node` is has property `name` (`boolean`).
+Whether `node` is an element that has a `field` property (`boolean`).
 
 ## Types
 
@@ -114,7 +113,7 @@ It exports no additional types.
 
 Projects maintained by the unified collective are compatible with all maintained
 versions of Node.js.
-As of now, that is Node.js 12.20+, 14.14+, 16.0+, and 18.0+.
+As of now, that is Node.js 14.14+ and 16.0+.
 Our projects sometimes work with older versions, but this is not guaranteed.
 
 ## Security
@@ -219,10 +218,8 @@ abide by its terms.
 
 [hast]: https://github.com/syntax-tree/hast
 
-[node]: https://github.com/syntax-tree/hast#nodes
-
 [element]: https://github.com/syntax-tree/hast#element
 
-[property]: https://github.com/syntax-tree/hast#property-names
-
 [xss]: https://en.wikipedia.org/wiki/Cross-site_scripting
+
+[hasproperty]: #haspropertynode-field