Add PlainObject type definition

kgryte · kgryte · commit f032448e0cfa · 2016-10-01T17:36:40.000-07:00
diff --git a/tools/docs/jsdoc/typedefs/objects.js b/tools/docs/jsdoc/typedefs/objects.js
@@ -4,6 +4,12 @@
 * @typedef {(Array|string|String|Object)} ArrayLike
 */
 
+/**
+* A plain object; i.e., either `{}` or an object created via `Object.create( null )`.
+*
+* @typedef {Object} PlainObject
+*/
+
 /**
 * A value which is object-like. Basically, any value which is not `null` and, when operated on by `typeof`, returns `object`.
 *
@@ -13,15 +19,15 @@
 /**
 * An object which is valid JSON.
 *
-* @typedef {Object} JSON
+* @typedef {PlainObject} JSON
 *
 * @see [JSON]{@link http://www.json.org/}
 */
 
 /**
 * An object containing function options.
 *
-* @typedef {Object} Options
+* @typedef {PlainObject} Options
 */
 
 /**
