@creejs/commons-lang 2.1.28 → 2.1.30

package/dist/esm/index-dev.js

@@ -32,6 +32,32 @@ class _Error extends Error {
     return err._type === '_' && typeof err.code === 'number'
   }
 
+  /**
+   *
+   * @param {string} message
+   * @param {number} time ms
+   * @returns {_Error}
+   */
+  static timeout (message, time) {
+    return new _Error(`Timeout ${time}ms: ${message}`, 504)
+  }
+
+  /**
+   * "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 Matched: ${message}`, 412)
+  }
+
   /**
    * Creates and returns a 404 Not Found error instance with the given message.
    * @param {string} message - The error message to include.
@@ -2083,6 +2109,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
@@ -2519,8 +2548,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