@creejs/commons-lang 2.1.13 → 2.1.15

package/dist/cjs/index-dev.cjs

@@ -1357,22 +1357,45 @@ function substringsBetween (str, startMarker, endMarker) {
 }
 
 /**
- * Executes a task silently, suppressing any errors or rejections.
+ * @module ExecUtils
+ * @description Utils about how to execute task functions.
+ */
+
+
+/**
+ * @typedef {{
+ *  error: (...args:any[]) => void,
+ *  warn: (...args:any[]) => void,
+ *  info: (...args:any[]) => void,
+ *  debug: (...args:any[]) => void,
+ *  trace: (...args:any[]) => void,
+ *  isErrorEnabled: () => boolean,
+ *  isWarnEnabled: () => boolean,
+ *  isInfoEnabled: () => boolean,
+ *  isDebugEnabled: () => boolean,
+ *  isTraceEnabled: () => boolean,
+ * }} LoggerLike
+ */
+
+/**
+ * 1. Executes a task silently, suppressing any errors or rejections.
+ * 2. if loggerLike is provided, will log the error via it
  * @param {Function} task - The export function to execute.
+ * @param {LoggerLike} [loggerLike] - The logger-like object to use for logging.
  * @returns {Promise<*>|*} The return value of the task, or a Promise if the task is asynchronous.
  */
-function quiet (task) {
+function quiet (task, loggerLike) {
   assertFunction(task);
   try {
     const rtnVal = task();
     if (isPromise(rtnVal)) {
-      return rtnVal.catch(() => {
-        // do nothing
+      return rtnVal.catch((/** @type {any} */ err) => {
+        loggerLike && loggerLike.isErrorEnabled() && loggerLike.error('quiet() with async error:', err);
       })
     }
     return rtnVal
-  } catch (e) {
-    // do nothing
+  } catch (err) {
+    loggerLike && loggerLike.isErrorEnabled() && loggerLike.error('quiet() with sync error:', err);
   }
 }
 
@@ -1737,6 +1760,7 @@ async function parallelAllSettled (tasks, maxParallel = 5) {
 
 // owned
 
+// module vars
 const { isPlainObject } = TypeUtils;
 
 /**
@@ -1801,6 +1825,8 @@ function newProxyInstance (cls, args, propertyHandler, sealed = true) {
   return Reflect.construct(proxyCls, args ?? [])
 }
 
+// owned
+
 /**
  * @module InstanceProxyUtils
  */
@@ -1827,7 +1853,6 @@ var InstanceProxyUtils = {
 
 // owned
 
-
 /**
  * Retrieves all unique method names from a class's prototype chain. *
  * @param {Function} cls - The class to inspect
@@ -1904,8 +1929,6 @@ var ReflectUtils = {
 };
 
 // internal
-
-
 // owned
 
 /**
@@ -1989,6 +2012,8 @@ function equals$1 (src, target) {
   return true
 }
 
+// owned
+
 var ArrayBufferUtils = {
   readString,
   writeString,