@creejs/commons-lang 2.1.27 → 2.1.29

package/dist/cjs/index-dev.cjs

@@ -36,6 +36,22 @@ class _Error extends Error {
     return err._type === '_' && typeof err.code === 'number'
   }
 
+  /**
+   * "412 Precondition Failed" indicates that one or more conditions
+   * given in the request header fields evaluated to false when tested on the server.
+   * * Header               Purpose
+   *  * If-Match            Only proceed if the resource's ETag matches the given value
+   *  * If-None-Match       Only proceed if the resource's ETag doesn't match the given value
+   *  * If-Modified-Since   Only proceed if the resource was modified after the given date
+   *  * If-Unmodified-Since Only proceed if the resource wasn't modified after the given date
+
+   * @param {string} message
+   * @returns {_Error}
+   */
+  static PreconditionFailed (message) {
+    return new _Error(`Not Found: ${message}`, 412)
+  }
+
   /**
    * Creates and returns a 404 Not Found error instance with the given message.
    * @param {string} message - The error message to include.
@@ -1541,6 +1557,45 @@ function safeToString (value) {
   } else if (value === undefined) {
     return 'undefined'
   }
+  const type = typeof value;
+  if (type === 'string') {
+    return value
+  } else if (type === 'symbol') {
+    return `Symbol(${value.description})`
+  } else if (type === 'function') {
+    return `Function ${value.name}(){}`
+  }
+  if (value instanceof String) {
+    return value.toString()
+  }
+  if (Number.isNaN(value)) {
+    return 'NaN'
+  }
+  if (value === Infinity) {
+    return 'Infinity'
+  }
+  if (value === -Infinity) {
+    return '-Infinity'
+  }
+  if (value instanceof Error) {
+    return `${value.constructor.name}: ${value.message}`
+  }
+  if (value instanceof Promise) {
+    return 'Promise'
+  }
+  if (value instanceof Set) {
+    return `Set: ${safeToString(Array.from(value))}`
+  }
+  if (value instanceof Map) {
+    return `Map: ${safeToString(Array.from(value.entries()))}`
+  }
+  if (value instanceof RegExp) {
+    return value.toString()
+  }
+
+  if (Array.isArray(value)) {
+    return `[${value.map(safeToString).join(', ')}]`
+  }
   let valueStr;
   try {
     valueStr = JSON.stringify(value);
@@ -2048,6 +2103,9 @@ async function parallelAllSettled (tasks, maxParallel = 5) {
  * 3. Notice:
  *    * In Beginning, we start bulk(maxParallel) of tasks
  *    * One task failed, it will start next task immediately, Not Wait for the bulk(maxParallel) to complete
+ *    * DO NOT ensure all tasks are executed.
+ *    * Tasks are NOT stoped immediately when a Task succeeds
+ *       * will be stopped when A bulk(maxParallel) is executed.
  * @param {Array<Function|Promise<any>>} tasks - Array of async functions to execute
  * @param {number} [maxParallel=5] - Maximum number of tasks to run in parallel
  * @param {string} [failureMessage] - Error message when all tasks failed
@@ -2484,8 +2542,8 @@ function writeString (buffer, str, offset = 0) {
  *    * if dataLength <= 0, throw "Not Positive" Error
  *    * if dataLength is omitted, read all bytes from dataOffset to the end of dataArrayBuffer
  *    * if dataLength + dataOffset > dataArrayBuffer.length, read all bytes from dataOffset to the end of dataArrayBuffer
- * @param {ArrayBuffer} target - The target buffer to write into.
- * @param {ArrayBuffer} dataArrayBuffer - The data ArrayBuffer to write.
+ * @param {ArrayBuffer|SharedArrayBuffer} target - The target buffer to write into.
+ * @param {ArrayBuffer|SharedArrayBuffer} dataArrayBuffer - The data ArrayBuffer to write.
  * @param {number} [targetOffset=0] - Zero-based index at which to start write.
  * @param {number} [dataOffset=0] - The offset in the dataArrayBuffer
  * @param {number} [dataLength] - how many bytes extract from dataArrayBuffer