[New] add isObject

Author: ljharb

README.md

@@ -15,6 +15,7 @@ ES Object-related atoms: Object, ToObject, RequireObjectCoercible.
 const assert = require('assert');
 
 const $Object = require('es-object-atoms');
+const isObject = require('es-object-atoms/isObject');
 const ToObject = require('es-object-atoms/ToObject');
 const RequireObjectCoercible = require('es-object-atoms/RequireObjectCoercible');
 
@@ -24,6 +25,12 @@ assert.throws(() => ToObject(undefined), TypeError);
 assert.throws(() => RequireObjectCoercible(null), TypeError);
 assert.throws(() => RequireObjectCoercible(undefined), TypeError);
 
+assert.equal(isObject(undefined), false);
+assert.equal(isObject(null), false);
+assert.equal(isObject({}), true);
+assert.equal(isObject([]), true);
+assert.equal(isObject(function () {}), true);
+
 assert.deepEqual(RequireObjectCoercible(true), true);
 assert.deepEqual(ToObject(true), Object(true));
 

isObject.d.ts

@@ -0,0 +1,3 @@
+declare function isObject(x: unknown): x is object;
+
+export = isObject;

isObject.js

@@ -0,0 +1,6 @@
+'use strict';
+
+/** @type {import('./isObject')} */
+module.exports = function isObject(x) {
+	return !!x && (typeof x === 'function' || typeof x === 'object');
+};

package.json

@@ -6,6 +6,7 @@
 	"exports": {
 		".": "./index.js",
 		"./RequireObjectCoercible": "./RequireObjectCoercible.js",
+		"./isObject": "./isObject.js",
 		"./ToObject": "./ToObject.js",
 		"./package.json": "./package.json"
 	},

test/index.js

@@ -3,7 +3,8 @@
 var test = require('tape');
 
 var $Object = require('../');
-var ToObject = require('..//ToObject');
+var isObject = require('../isObject');
+var ToObject = require('../ToObject');
 var RequireObjectCoercible = require('..//RequireObjectCoercible');
 
 test('errors', function (t) {
@@ -20,6 +21,12 @@ test('errors', function (t) {
 	t.deepEqual(RequireObjectCoercible(true), true);
 	t.deepEqual(ToObject(true), Object(true));
 
+	t.equal(isObject(undefined), false);
+	t.equal(isObject(null), false);
+	t.equal(isObject({}), true);
+	t.equal(isObject([]), true);
+	t.equal(isObject(function () {}), true);
+
 	var obj = {};
 	t.equal(RequireObjectCoercible(obj), obj);
 	t.equal(ToObject(obj), obj);