feat: add Object.ensureFiniteNumber util

object/ensure-finite-number.js

@@ -0,0 +1,9 @@
+"use strict";
+
+var isFiniteNumber = require("./is-finite-number")
+  , safeToString   = require("../safe-to-string");
+
+module.exports = function (value) {
+	if (isFiniteNumber(value)) return Number(value);
+	throw new TypeError(safeToString + " does not represent a finite number value");
+};

object/index.js

@@ -9,6 +9,7 @@ module.exports = {
 	copyDeep: require("./copy-deep"),
 	count: require("./count"),
 	create: require("./create"),
+	ensureFiniteNumber: require("./ensure-finite-number"),
 	ensureNaturalNumber: require("./ensure-natural-number"),
 	ensureNaturalNumberValue: require("./ensure-natural-number-value"),
 	ensurePromise: require("./ensure-promise"),

test/object/ensure-finite-number.js

@@ -0,0 +1,54 @@
+"use strict";
+
+module.exports = function (t, a) {
+	a.throws(
+		function () {
+			t(undefined);
+		},
+		TypeError,
+		"Undefined"
+	);
+	a.throws(
+		function () {
+			t(null);
+		},
+		TypeError,
+		"Null"
+	);
+	a(t(0), 0, "Zero");
+	a.throws(
+		function () {
+			t(NaN);
+		},
+		TypeError,
+		"NaN"
+	);
+	a.throws(
+		function () {
+			t(Infinity);
+		},
+		TypeError,
+		"Infinity"
+	);
+	a(t(12), 12, "Number");
+	a(t(false), 0, "Boolean");
+	a(t(new Date(1000000)), 1000000, "Date");
+	a(t(new Number(2)), 2, "Number object");
+	a.throws(
+		function () {
+			t("asdfaf");
+		},
+		TypeError,
+		"String"
+	);
+	a(t(""), 0, "Empty String");
+	if (typeof Symbol === "function") {
+		a.throws(
+			function () {
+				t(Symbol("test"));
+			},
+			TypeError,
+			"Symbol"
+		);
+	}
+};