some-common-functions-js 1.0.8 → 1.0.9

package/CHANGELOG.md

@@ -29,3 +29,7 @@ Improve README.md documentation.
 
 ## Version 1.0.8 - 2025/11/21 - ITA
 - Corrected test code and README documentation
+
+## Version 1.0.9 - 2025/11/28 - ITA
+- Provided more documentation in test.js to remind a developer how to symbolic-link (mimick as installed) the package and running the test code.
+- Added new function, hasOnlyAll(), and updated the README.md documentation accordingly.

package/README.md

@@ -73,6 +73,28 @@ let result = hasAll(car, "make", "model");
 
 let result = hasAll(car, "passengerCapacity", "year");  
 // false, because car does not have "passengerCapacity" field.  
+```
+### `hasOnlyAll(anObject, ...fields)`
+Return `true` if an object contains only all the specified fields, nothing more, nothing less
+***Example***
+```
+const { hasOnlyAll } = require("some-common-functions-js");  
+let car = {  
+    make: "Ford",  
+    model: "Ranger",  
+    year: "2015",  
+    power: "1000kW",  
+    type: "pickup truck"  
+};  
+let result = hasOnlyAll(car, "make", "model");  
+// false, because car has all the specified fields and extra fields.  
+
+let result = hasOnlyAll(car, "passengerCapacity", "year");  
+// false, because car does not have "passengerCapacity" field.  
+
+let result = hasOnlyAll(car, "make", "model", "power", "type");  
+// true, because car has all the specified fields, nothing less, nothing more.  
+
 ```
 ---
 
@@ -109,13 +131,13 @@ Compares two values of the same primitive type, according to the sort direction.
 ```
 const { compare } = require("some-common-functions-js");  
 
-let x = "Fong Kong";  
+let x = "Jiāng Fāng";  
 let y = "Isaiah Tshabalala";  
-let result = compare(x, y);  // -1 because "Fong Kong" is before "Isaiah Tshabalala" in ascending order.  
+let result = compare(x, y);  // -1 because "Jiāng Fāng" is before "Isaiah Tshabalala" in ascending order.  
 result = compare(y, x);  
-console.log(result); // 1 because "Isaiah Tshabalala" is after "Fong Kong" in ascending order.  
+console.log(result); // 1 because "Isaiah Tshabalala" is after "Jiāng Fāng" in ascending order.  
 result = compare(x, y, 'desc');  
-console.log(result); // 1 because "Fong Kong" is after "Isaiah Tshabalala" in descending order.
+console.log(result); // 1 because "Jiāng Fāng" is after "Isaiah Tshabalala" in descending order.
 ```
 ### `binarySearch(anArray, searchVal, startFrom = 0, arraySortDir = 'asc')`
 Binary Searches a sorted primitive type array for a value and returns the index.  

package/index.js

@@ -2,6 +2,7 @@
  * Description: Common functions to be put here.
  * Date        Dev   Version  Description
  * 2025/11/19  ITA   1.00     Genesis.
+ * 2025/11/28  ITA   1.01     Added function hasOnlyAll().
 */
 const loDash = require('lodash');
 
@@ -157,6 +158,16 @@ function hasAll(anObject, ...fields) {
 }
 module.exports.hasAll = hasAll;
 
+/**
+ * Determine whether an object contains only all of the specified fields. Nothing more, nothing less.
+ * @param {*} anObject a Javascript object.
+ * @param  {...string} fields one or field names.
+ * @returns boolean.
+ */
+function hasOnlyAll(anObject, ...fields) {
+    return hasOnly(anObject, ...fields) && hasAll(anObject, ...fields);
+}
+module.exports.hasOnlyAll = hasOnlyAll;
 
 /**Binary Search the sorted primitive data array for a value and return the index.
  * ArraySortDir specifies the direction in which the array is sorted (desc or asc).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "some-common-functions-js",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "Common functions used with Javascript objects, and field validation functions.",
   "keywords": [
     "validation",