w-orm-lowdb 1.0.35 → 1.0.36

package/docs/WOrmLowdb.mjs.html

@@ -91,6 +91,8 @@ let kpGqueue = {}
  * data為本次操作之輸入數據，無輸入數據者為null。
  * err為錯誤訊息字串，內容與正規管道所送出者一致。
  * 整批性錯誤於reject之前發出；逐筆失敗於該筆結果定案後發出，每筆一次。
+ * insert、insertBulk、save與del因輸入本身導致之失敗(如原型為null之Date使複製拋錯、存取器拋錯)亦屬整批性錯誤，同樣於reject之前恰發出一次、不發出change事件、資料庫不變；
+ * 拋錯於複製建立之前者，data為呼叫端傳入之原值，其後者為複製；err為拋出者之原訊息(呼叫端自行拋出之值或訊息原樣通過，無法轉為字串者以固定訊息unknown error取代)，本套件不另行回顯數據內容。
  * 註: 逐筆失敗時整批仍resolve，故收到本事件不表示該次呼叫失敗；正常結果(如查無數據、主鍵未命中、全數已存在)不發出本事件。
  *
  * 註: 本套件之主鍵欄位固定為id，尚未支援指定其他欄位為主鍵。
@@ -357,9 +359,17 @@ function WOrmLowdb(opt = {}) {
     }
 
     //emitError, 操作發生錯誤時發出, 錯誤訊息一律轉為字串
+    //拋出之值本身可能無法轉為字串(如呼叫端之存取器拋出null原型物件, 或其message存取器拋錯), 此時以固定訊息取代, 令error事件仍恰發出一次(帳本R-WRITE-ERR-01), reject之值不變
     let emitError = (mode, data, err) => {
+        let msg = 'unknown error'
         try {
-            ee.emit('error', mode, data, getErrMsg(err))
+            msg = getErrMsg(err)
+        }
+        catch (errMsg) {
+            //無法轉為字串者沿用固定訊息
+        }
+        try {
+            ee.emit('error', mode, data, msg)
         }
         catch (errEmit) {
             console.log(errEmit)
@@ -598,31 +608,31 @@ function WOrmLowdb(opt = {}) {
     async function insertCore(data, option = {}) {
         let isErr = false
 
-        //returnList
-        let returnList = get(option, 'returnList')
-        if (!isbol(returnList)) {
-            returnList = false
-        }
+        //res
+        let res = null
+        try {
 
-        //check
-        if (!iseobj(data) && !isearr(data)) {
-            if (returnList) {
-                //輸入無效, 對齊save與del之空陣列規定
-                return []
+            //returnList, 讀取呼叫端傳入之option、判定data與cloneDeep皆可能因輸入而拋錯, 故一律置於try內(帳本R-WRITE-ERR-01)
+            let returnList = get(option, 'returnList')
+            if (!isbol(returnList)) {
+                returnList = false
             }
-            return {
-                n: 0,
-                nInserted: 0,
-                ok: 1,
-            }
-        }
 
-        //cloneDeep, 與外部數據脫勾
-        data = cloneDeep(data)
+            //check, 輸入無效者直接回傳, 不經catch之後之收尾且不發事件
+            if (!iseobj(data) && !isearr(data)) {
+                if (returnList) {
+                    //輸入無效, 對齊save與del之空陣列規定
+                    return []
+                }
+                return {
+                    n: 0,
+                    nInserted: 0,
+                    ok: 1,
+                }
+            }
 
-        //res
-        let res = null
-        try {
+            //cloneDeep, 與外部數據脫勾, 其拋錯者(如原型為null之Date)亦走同一錯誤路徑(error事件恰一次後reject)
+            data = cloneDeep(data)
 
             //check
             if (!isarr(data)) {
@@ -736,22 +746,22 @@ function WOrmLowdb(opt = {}) {
     async function insertBulkCore(data) {
         let isErr = false
 
-        //check
-        if (!iseobj(data) && !isearr(data)) {
-            return {
-                n: 0,
-                nInserted: 0,
-                ok: 1,
-            }
-        }
-
-        //cloneDeep, 與外部數據脫勾
-        data = cloneDeep(data)
-
         //res
         let res = null
         try {
 
+            //check, 判定data與cloneDeep皆可能因輸入而拋錯, 故一律置於try內(帳本R-WRITE-ERR-01); 輸入無效者直接回傳, 不經catch之後之收尾且不發事件
+            if (!iseobj(data) && !isearr(data)) {
+                return {
+                    n: 0,
+                    nInserted: 0,
+                    ok: 1,
+                }
+            }
+
+            //cloneDeep, 與外部數據脫勾, 其拋錯者(如原型為null之Date)亦走同一錯誤路徑(error事件恰一次後reject)
+            data = cloneDeep(data)
+
             //check
             if (!isarr(data)) {
                 data = [data]
@@ -843,21 +853,21 @@ function WOrmLowdb(opt = {}) {
     async function saveCore(data, option = {}) {
         let isErr = false
 
-        //check
-        if (!iseobj(data) && !isearr(data)) {
-            return []
-        }
-
-        //cloneDeep, 與外部數據脫勾
-        data = cloneDeep(data)
-
-        //autoInsert
-        let autoInsert = get(option, 'autoInsert', true)
-
         //res
         let res = null
         try {
 
+            //check, 判定data、cloneDeep與讀取呼叫端傳入之option皆可能因輸入而拋錯, 故一律置於try內(帳本R-WRITE-ERR-01); 輸入無效者直接回傳, 不經catch之後之收尾且不發事件
+            if (!iseobj(data) && !isearr(data)) {
+                return []
+            }
+
+            //cloneDeep, 與外部數據脫勾, 其拋錯者(如原型為null之Date)亦走同一錯誤路徑(error事件恰一次後reject)
+            data = cloneDeep(data)
+
+            //autoInsert
+            let autoInsert = get(option, 'autoInsert', true)
+
             //check
             if (!isarr(data)) {
                 data = [data]
@@ -1042,18 +1052,18 @@ function WOrmLowdb(opt = {}) {
     async function delCore(data) {
         let isErr = false
 
-        //check
-        if (!iseobj(data) && !isearr(data)) {
-            return []
-        }
-
-        //cloneDeep, 與外部數據脫勾
-        data = cloneDeep(data)
-
         //res
         let res = null
         try {
 
+            //check, 判定data與cloneDeep皆可能因輸入而拋錯, 故一律置於try內(帳本R-WRITE-ERR-01); 輸入無效者直接回傳, 不經catch之後之收尾且不發事件
+            if (!iseobj(data) && !isearr(data)) {
+                return []
+            }
+
+            //cloneDeep, 與外部數據脫勾, 其拋錯者(如原型為null之Date)亦走同一錯誤路徑(error事件恰一次後reject)
+            data = cloneDeep(data)
+
             //check
             if (!isarr(data)) {
                 data = [data]
@@ -1340,7 +1350,7 @@ export default WOrmLowdb
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Tue Oct 20 2026 01:55:52 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Tue Oct 20 2026 12:54:27 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/index.html

@@ -71,7 +71,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Tue Oct 20 2026 01:55:52 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Tue Oct 20 2026 12:54:27 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "w-orm-lowdb",
-  "version": "1.0.35",
+  "version": "1.0.36",
   "main": "dist/w-orm-lowdb.umd.js",
   "dependencies": {
     "lowdb": "^7.0.1",

package/src/WOrmLowdb.mjs

@@ -44,6 +44,8 @@ let kpGqueue = {}
  * data為本次操作之輸入數據，無輸入數據者為null。
  * err為錯誤訊息字串，內容與正規管道所送出者一致。
  * 整批性錯誤於reject之前發出；逐筆失敗於該筆結果定案後發出，每筆一次。
+ * insert、insertBulk、save與del因輸入本身導致之失敗(如原型為null之Date使複製拋錯、存取器拋錯)亦屬整批性錯誤，同樣於reject之前恰發出一次、不發出change事件、資料庫不變；
+ * 拋錯於複製建立之前者，data為呼叫端傳入之原值，其後者為複製；err為拋出者之原訊息(呼叫端自行拋出之值或訊息原樣通過，無法轉為字串者以固定訊息unknown error取代)，本套件不另行回顯數據內容。
  * 註: 逐筆失敗時整批仍resolve，故收到本事件不表示該次呼叫失敗；正常結果(如查無數據、主鍵未命中、全數已存在)不發出本事件。
  *
  * 註: 本套件之主鍵欄位固定為id，尚未支援指定其他欄位為主鍵。
@@ -310,9 +312,17 @@ function WOrmLowdb(opt = {}) {
     }
 
     //emitError, 操作發生錯誤時發出, 錯誤訊息一律轉為字串
+    //拋出之值本身可能無法轉為字串(如呼叫端之存取器拋出null原型物件, 或其message存取器拋錯), 此時以固定訊息取代, 令error事件仍恰發出一次(帳本R-WRITE-ERR-01), reject之值不變
     let emitError = (mode, data, err) => {
+        let msg = 'unknown error'
         try {
-            ee.emit('error', mode, data, getErrMsg(err))
+            msg = getErrMsg(err)
+        }
+        catch (errMsg) {
+            //無法轉為字串者沿用固定訊息
+        }
+        try {
+            ee.emit('error', mode, data, msg)
         }
         catch (errEmit) {
             console.log(errEmit)
@@ -551,31 +561,31 @@ function WOrmLowdb(opt = {}) {
     async function insertCore(data, option = {}) {
         let isErr = false
 
-        //returnList
-        let returnList = get(option, 'returnList')
-        if (!isbol(returnList)) {
-            returnList = false
-        }
+        //res
+        let res = null
+        try {
 
-        //check
-        if (!iseobj(data) && !isearr(data)) {
-            if (returnList) {
-                //輸入無效, 對齊save與del之空陣列規定
-                return []
+            //returnList, 讀取呼叫端傳入之option、判定data與cloneDeep皆可能因輸入而拋錯, 故一律置於try內(帳本R-WRITE-ERR-01)
+            let returnList = get(option, 'returnList')
+            if (!isbol(returnList)) {
+                returnList = false
             }
-            return {
-                n: 0,
-                nInserted: 0,
-                ok: 1,
-            }
-        }
 
-        //cloneDeep, 與外部數據脫勾
-        data = cloneDeep(data)
+            //check, 輸入無效者直接回傳, 不經catch之後之收尾且不發事件
+            if (!iseobj(data) && !isearr(data)) {
+                if (returnList) {
+                    //輸入無效, 對齊save與del之空陣列規定
+                    return []
+                }
+                return {
+                    n: 0,
+                    nInserted: 0,
+                    ok: 1,
+                }
+            }
 
-        //res
-        let res = null
-        try {
+            //cloneDeep, 與外部數據脫勾, 其拋錯者(如原型為null之Date)亦走同一錯誤路徑(error事件恰一次後reject)
+            data = cloneDeep(data)
 
             //check
             if (!isarr(data)) {
@@ -689,22 +699,22 @@ function WOrmLowdb(opt = {}) {
     async function insertBulkCore(data) {
         let isErr = false
 
-        //check
-        if (!iseobj(data) && !isearr(data)) {
-            return {
-                n: 0,
-                nInserted: 0,
-                ok: 1,
-            }
-        }
-
-        //cloneDeep, 與外部數據脫勾
-        data = cloneDeep(data)
-
         //res
         let res = null
         try {
 
+            //check, 判定data與cloneDeep皆可能因輸入而拋錯, 故一律置於try內(帳本R-WRITE-ERR-01); 輸入無效者直接回傳, 不經catch之後之收尾且不發事件
+            if (!iseobj(data) && !isearr(data)) {
+                return {
+                    n: 0,
+                    nInserted: 0,
+                    ok: 1,
+                }
+            }
+
+            //cloneDeep, 與外部數據脫勾, 其拋錯者(如原型為null之Date)亦走同一錯誤路徑(error事件恰一次後reject)
+            data = cloneDeep(data)
+
             //check
             if (!isarr(data)) {
                 data = [data]
@@ -796,21 +806,21 @@ function WOrmLowdb(opt = {}) {
     async function saveCore(data, option = {}) {
         let isErr = false
 
-        //check
-        if (!iseobj(data) && !isearr(data)) {
-            return []
-        }
-
-        //cloneDeep, 與外部數據脫勾
-        data = cloneDeep(data)
-
-        //autoInsert
-        let autoInsert = get(option, 'autoInsert', true)
-
         //res
         let res = null
         try {
 
+            //check, 判定data、cloneDeep與讀取呼叫端傳入之option皆可能因輸入而拋錯, 故一律置於try內(帳本R-WRITE-ERR-01); 輸入無效者直接回傳, 不經catch之後之收尾且不發事件
+            if (!iseobj(data) && !isearr(data)) {
+                return []
+            }
+
+            //cloneDeep, 與外部數據脫勾, 其拋錯者(如原型為null之Date)亦走同一錯誤路徑(error事件恰一次後reject)
+            data = cloneDeep(data)
+
+            //autoInsert
+            let autoInsert = get(option, 'autoInsert', true)
+
             //check
             if (!isarr(data)) {
                 data = [data]
@@ -995,18 +1005,18 @@ function WOrmLowdb(opt = {}) {
     async function delCore(data) {
         let isErr = false
 
-        //check
-        if (!iseobj(data) && !isearr(data)) {
-            return []
-        }
-
-        //cloneDeep, 與外部數據脫勾
-        data = cloneDeep(data)
-
         //res
         let res = null
         try {
 
+            //check, 判定data與cloneDeep皆可能因輸入而拋錯, 故一律置於try內(帳本R-WRITE-ERR-01); 輸入無效者直接回傳, 不經catch之後之收尾且不發事件
+            if (!iseobj(data) && !isearr(data)) {
+                return []
+            }
+
+            //cloneDeep, 與外部數據脫勾, 其拋錯者(如原型為null之Date)亦走同一錯誤路徑(error事件恰一次後reject)
+            data = cloneDeep(data)
+
             //check
             if (!isarr(data)) {
                 data = [data]