w-orm-lowdb 1.0.7 → 1.0.9

package/docs/WOrmLowdb.html

@@ -80,7 +80,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="WOrmLowdb.mjs.html">WOrmLowdb.mjs</a>, <a href="WOrmLowdb.mjs.html#line38">line 38</a>
+        <a href="WOrmLowdb.mjs.html">WOrmLowdb.mjs</a>, <a href="WOrmLowdb.mjs.html#line40">line 40</a>
     </li></ul></dd>
     
 
@@ -336,6 +336,46 @@
         </tr>
 
     
+
+        <tr>
+            
+                <td class="name"><code>useCache</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Boolean</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>false</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入是否使用select快取，適用於單程序操作，預設false</p></td>
+        </tr>
+
+    
     </tbody>
 </table>
 
@@ -429,7 +469,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="WOrmLowdb.mjs.html">WOrmLowdb.mjs</a>, <a href="WOrmLowdb.mjs.html#line623">line 623</a>
+        <a href="WOrmLowdb.mjs.html">WOrmLowdb.mjs</a>, <a href="WOrmLowdb.mjs.html#line635">line 635</a>
     </li></ul></dd>
     
 
@@ -607,7 +647,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="WOrmLowdb.mjs.html">WOrmLowdb.mjs</a>, <a href="WOrmLowdb.mjs.html#line470">line 470</a>
+        <a href="WOrmLowdb.mjs.html">WOrmLowdb.mjs</a>, <a href="WOrmLowdb.mjs.html#line482">line 482</a>
     </li></ul></dd>
     
 
@@ -768,7 +808,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="WOrmLowdb.mjs.html">WOrmLowdb.mjs</a>, <a href="WOrmLowdb.mjs.html#line173">line 173</a>
+        <a href="WOrmLowdb.mjs.html">WOrmLowdb.mjs</a>, <a href="WOrmLowdb.mjs.html#line185">line 185</a>
     </li></ul></dd>
     
 
@@ -929,7 +969,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="WOrmLowdb.mjs.html">WOrmLowdb.mjs</a>, <a href="WOrmLowdb.mjs.html#line302">line 302</a>
+        <a href="WOrmLowdb.mjs.html">WOrmLowdb.mjs</a>, <a href="WOrmLowdb.mjs.html#line314">line 314</a>
     </li></ul></dd>
     
 
@@ -1216,7 +1256,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="WOrmLowdb.mjs.html">WOrmLowdb.mjs</a>, <a href="WOrmLowdb.mjs.html#line116">line 116</a>
+        <a href="WOrmLowdb.mjs.html">WOrmLowdb.mjs</a>, <a href="WOrmLowdb.mjs.html#line128">line 128</a>
     </li></ul></dd>
     
 
@@ -1393,7 +1433,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Thu May 14 2026 18:57:20 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 Fri May 15 2026 13:15:06 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/WOrmLowdb.mjs.html

@@ -60,6 +60,7 @@ import cloneDeep from 'lodash-es/cloneDeep.js'
 import genID from 'wsemi/src/genID.mjs'
 import pmSeries from 'wsemi/src/pmSeries.mjs'
 import isarr from 'wsemi/src/isarr.mjs'
+import isbol from 'wsemi/src/isbol.mjs'
 import isestr from 'wsemi/src/isestr.mjs'
 import iseobj from 'wsemi/src/iseobj.mjs'
 import isearr from 'wsemi/src/isearr.mjs'
@@ -80,6 +81,7 @@ let kpGlock = {}
  * @param {String} [opt.url='./db.json'] 輸入資料庫位置字串，預設'./db.json'
  * @param {String} [opt.db='worm'] 輸入使用資料庫名稱字串，預設'worm'
  * @param {String} [opt.cl='test'] 輸入使用資料表名稱字串，預設'test'
+ * @param {Boolean} [opt.useCache=false] 輸入是否使用select快取，適用於單程序操作，預設false
  * @returns {Object} 回傳操作資料庫物件，各事件功能詳見說明
  */
 function WOrmLowdb(opt = {}) {
@@ -105,6 +107,12 @@ function WOrmLowdb(opt = {}) {
         cl = 'test'
     }
 
+    //useCache
+    let useCache = get(opt, 'useCache')
+    if (!isbol(useCache)) {
+        useCache = false
+    }
+
     //key
     let key = `${db}:${cl}`
 
@@ -135,7 +143,7 @@ function WOrmLowdb(opt = {}) {
     let getData = async() => {
 
         //check
-        if (isarr(_cache)) {
+        if (useCache && isarr(_cache)) {
             return cloneDeep(_cache) //與外部使用數據脫勾
         }
 
@@ -147,10 +155,14 @@ function WOrmLowdb(opt = {}) {
             lowdb.data[key] = []
         }
 
-        //update
-        _cache = lowdb.data[key]
+        //ltdt
+        let ltdt = cloneDeep(lowdb.data[key]) //數據為lowdb內部的記憶體狀態本體, 須cloneDeep與外部使用數據脫勾
 
-        return cloneDeep(_cache) //與外部使用數據脫勾
+        if (useCache) {
+            _cache = ltdt
+            return cloneDeep(ltdt) //與外部使用數據脫勾
+        }
+        return ltdt
     }
 
     /**
@@ -401,8 +413,11 @@ function WOrmLowdb(opt = {}) {
                 //查找資料表內v.id
                 let r = get(kp, v.id, null)
 
+                //existed
+                let existed = iseobj(r)
+
                 //check
-                if (iseobj(r)) {
+                if (existed) {
                     //已存在v.id
                     if (isEqual(v, r.v)) {
                         //內容相同不更新
@@ -417,6 +432,9 @@ function WOrmLowdb(opt = {}) {
                         b = true
                     }
                 }
+                else {
+                    //內容不存在
+                }
 
                 //rest
                 if (iseobj(rest)) {
@@ -433,34 +451,28 @@ function WOrmLowdb(opt = {}) {
                         ok: 1,
                     }
                 }
+                //rest.n === 0:
+                // 內容相同不更新, 不須update
+                // 內容不存在, 若autoInsert則須insert
 
-                //autoInsert
-                if (autoInsert && rest.n === 0) {
-                    if (!haskey(kp, v.id)) {
-                        let k = size(lowdb.data[key])
-                        lowdb.data[key].push(v)
-                        kp[v.id] = {
-                            k,
-                            v: lowdb.data[key][k],
-                        }
-                        b = true
-                        rest = {
-                            n: 1,
-                            nInserted: 1,
-                            ok: 1,
-                        }
-                    }
-                    else {
-                        rest = {
-                            n: 1,
-                            nInserted: 0,
-                            ok: 1,
-                        }
-                    }
-                }
-
-                return rest
-            })
+                //autoInsert
+                if (autoInsert && rest.n === 0 && !existed) {
+                    let k = size(lowdb.data[key])
+                    lowdb.data[key].push(v)
+                    kp[v.id] = {
+                        k,
+                        v: lowdb.data[key][k],
+                    }
+                    b = true
+                    rest = {
+                        n: 1,
+                        nInserted: 1,
+                        ok: 1,
+                    }
+                }
+
+                return rest
+            })
 
             //write
             if (b) {
@@ -824,7 +836,7 @@ export default WOrmLowdb
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Thu May 14 2026 18:57:20 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 Fri May 15 2026 13:15:06 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 Thu May 14 2026 18:57:20 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 Fri May 15 2026 13:15:06 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/g-basic.mjs

@@ -44,6 +44,14 @@ let rsm = [
     },
 ]
 
+let rsa = [
+    {
+        id: 'id-rosemary',
+        name: 'rosemary',
+        value: 654.321,
+    },
+]
+
 async function test() {
 
     //wo
@@ -105,6 +113,15 @@ async function test() {
     // let sr = await wo.select({ name: { $regex: 'PeT', $options: '$i' } })
     // console.log('selectReg', sr)
 
+    //save
+    await wo.save(rsa, { autoInsert: true })
+        .then(function(msg) {
+            console.log('save then', msg)
+        })
+        .catch(function(msg) {
+            console.log('save catch', msg)
+        })
+
     //del
     let d = ss.filter(function(v) {
         return v.name === 'kettle'
@@ -159,6 +176,8 @@ test()
 //     value: 456
 //   }
 // ]
+// change save
+// save then [ { n: 1, nModified: 1, ok: 1 } ]
 // change del
 // del then [ { n: 1, nDeleted: 1, ok: 1 } ]
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "w-orm-lowdb",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "main": "dist/w-orm-lowdb.umd.js",
   "dependencies": {
     "lodash-es": "^4.18.1",

package/src/WOrmLowdb.mjs

@@ -13,6 +13,7 @@ import cloneDeep from 'lodash-es/cloneDeep.js'
 import genID from 'wsemi/src/genID.mjs'
 import pmSeries from 'wsemi/src/pmSeries.mjs'
 import isarr from 'wsemi/src/isarr.mjs'
+import isbol from 'wsemi/src/isbol.mjs'
 import isestr from 'wsemi/src/isestr.mjs'
 import iseobj from 'wsemi/src/iseobj.mjs'
 import isearr from 'wsemi/src/isearr.mjs'
@@ -33,6 +34,7 @@ let kpGlock = {}
  * @param {String} [opt.url='./db.json'] 輸入資料庫位置字串，預設'./db.json'
  * @param {String} [opt.db='worm'] 輸入使用資料庫名稱字串，預設'worm'
  * @param {String} [opt.cl='test'] 輸入使用資料表名稱字串，預設'test'
+ * @param {Boolean} [opt.useCache=false] 輸入是否使用select快取，適用於單程序操作，預設false
  * @returns {Object} 回傳操作資料庫物件，各事件功能詳見說明
  */
 function WOrmLowdb(opt = {}) {
@@ -58,6 +60,12 @@ function WOrmLowdb(opt = {}) {
         cl = 'test'
     }
 
+    //useCache
+    let useCache = get(opt, 'useCache')
+    if (!isbol(useCache)) {
+        useCache = false
+    }
+
     //key
     let key = `${db}:${cl}`
 
@@ -88,7 +96,7 @@ function WOrmLowdb(opt = {}) {
     let getData = async() => {
 
         //check
-        if (isarr(_cache)) {
+        if (useCache && isarr(_cache)) {
             return cloneDeep(_cache) //與外部使用數據脫勾
         }
 
@@ -100,10 +108,14 @@ function WOrmLowdb(opt = {}) {
             lowdb.data[key] = []
         }
 
-        //update
-        _cache = lowdb.data[key]
+        //ltdt
+        let ltdt = cloneDeep(lowdb.data[key]) //數據為lowdb內部的記憶體狀態本體, 須cloneDeep與外部使用數據脫勾
 
-        return cloneDeep(_cache) //與外部使用數據脫勾
+        if (useCache) {
+            _cache = ltdt
+            return cloneDeep(ltdt) //與外部使用數據脫勾
+        }
+        return ltdt
     }
 
     /**
@@ -354,8 +366,11 @@ function WOrmLowdb(opt = {}) {
                 //查找資料表內v.id
                 let r = get(kp, v.id, null)
 
+                //existed
+                let existed = iseobj(r)
+
                 //check
-                if (iseobj(r)) {
+                if (existed) {
                     //已存在v.id
                     if (isEqual(v, r.v)) {
                         //內容相同不更新
@@ -370,6 +385,9 @@ function WOrmLowdb(opt = {}) {
                         b = true
                     }
                 }
+                else {
+                    //內容不存在
+                }
 
                 //rest
                 if (iseobj(rest)) {
@@ -386,34 +404,28 @@ function WOrmLowdb(opt = {}) {
                         ok: 1,
                     }
                 }
+                //rest.n === 0:
+                // 內容相同不更新, 不須update
+                // 內容不存在, 若autoInsert則須insert
 
-                //autoInsert
-                if (autoInsert && rest.n === 0) {
-                    if (!haskey(kp, v.id)) {
-                        let k = size(lowdb.data[key])
-                        lowdb.data[key].push(v)
-                        kp[v.id] = {
-                            k,
-                            v: lowdb.data[key][k],
-                        }
-                        b = true
-                        rest = {
-                            n: 1,
-                            nInserted: 1,
-                            ok: 1,
-                        }
-                    }
-                    else {
-                        rest = {
-                            n: 1,
-                            nInserted: 0,
-                            ok: 1,
-                        }
-                    }
-                }
-
-                return rest
-            })
+                //autoInsert
+                if (autoInsert && rest.n === 0 && !existed) {
+                    let k = size(lowdb.data[key])
+                    lowdb.data[key].push(v)
+                    kp[v.id] = {
+                        k,
+                        v: lowdb.data[key][k],
+                    }
+                    b = true
+                    rest = {
+                        n: 1,
+                        nInserted: 1,
+                        ok: 1,
+                    }
+                }
+
+                return rest
+            })
 
             //write
             if (b) {