@creejs/commons-lang 2.1.27 → 2.1.29

package/dist/umd/index.dev.js

@@ -38,6 +38,22 @@
       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.
@@ -1543,6 +1559,45 @@
     } 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);
@@ -2050,6 +2105,9 @@
    * 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
@@ -2486,8 +2544,8 @@
    *    * 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