w-orm-lowdb 1.0.13 → 1.0.14

package/docs/index.html

@@ -29,7 +29,7 @@
 <nav >
     
     
-    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="WOrmLowdb.html">WOrmLowdb</a><ul class='methods'><li data-type='method'><a href="WOrmLowdb.html#.delAllCore">delAllCore</a></li><li data-type='method'><a href="WOrmLowdb.html#.delCore">delCore</a></li><li data-type='method'><a href="WOrmLowdb.html#.insertCore">insertCore</a></li><li data-type='method'><a href="WOrmLowdb.html#.saveCore">saveCore</a></li><li data-type='method'><a href="WOrmLowdb.html#.selectCore">selectCore</a></li></ul></li></ul>
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="WOrmLowdb.html">WOrmLowdb</a><ul class='methods'><li data-type='method'><a href="WOrmLowdb.html#.delAllCore">delAllCore</a></li><li data-type='method'><a href="WOrmLowdb.html#.delCore">delCore</a></li><li data-type='method'><a href="WOrmLowdb.html#.insertBulkCore">insertBulkCore</a></li><li data-type='method'><a href="WOrmLowdb.html#.insertCore">insertCore</a></li><li data-type='method'><a href="WOrmLowdb.html#.saveCore">saveCore</a></li><li data-type='method'><a href="WOrmLowdb.html#.selectByPkCore">selectByPkCore</a></li><li data-type='method'><a href="WOrmLowdb.html#.selectCore">selectCore</a></li><li data-type='method'><a href="WOrmLowdb.html#~serialize">serialize</a></li></ul></li></ul>
     
 </nav>
 
@@ -71,7 +71,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sat Aug 08 2026 14:30:09 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 Mon Aug 17 2026 20:57:08 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/g-basic.mjs

@@ -1,185 +1,203 @@
-import WOrm from './src/WOrmLowdb.mjs'
-//import WOrm from './dist/w-orm-lowdb.umd.js'
-// import w from 'wsemi'
-
-
-// w.fsDeleteFile('./db.json')
-
-let opt = {
-    url: './db.json',
-    db: 'worm',
-    cl: 'users',
-}
-
-let rs = [
-    {
-        id: 'id-peter',
-        name: 'peter',
-        value: 123,
-    },
-    {
-        id: 'id-rosemary',
-        name: 'rosemary',
-        value: 123.456,
-    },
-    {
-        id: '',
-        name: 'kettle',
-        value: 456,
-    },
-]
-
-let rsm = [
-    {
-        id: 'id-peter',
-        name: 'peter(modify)'
-    },
-    {
-        id: 'id-rosemary',
-        name: 'rosemary(modify)'
-    },
-    {
-        id: '',
-        name: 'kettle(modify)'
-    },
-]
-
-let rsa = [
-    {
-        id: 'id-rosemary',
-        name: 'rosemary',
-        value: 654.321,
-    },
-]
-
-async function test() {
-
-    //wo
-    let wo = WOrm(opt)
-
-    //on
-    wo.on('change', function(mode, data, res) {
-        console.log('change', mode)
-    })
-
-    //delAll
-    await wo.delAll()
-        .then(function(msg) {
-            console.log('delAll then', msg)
-        })
-        .catch(function(msg) {
-            console.log('delAll catch', msg)
-        })
-
-    //insert
-    await wo.insert(rs)
-        .then(function(msg) {
-            console.log('insert then', msg)
-        })
-        .catch(function(msg) {
-            console.log('insert catch', msg)
-        })
-
-    //save
-    await wo.save(rsm, { autoInsert: false })
-        .then(function(msg) {
-            console.log('save then', msg)
-        })
-        .catch(function(msg) {
-            console.log('save catch', msg)
-        })
-
-    //select all
-    let ss = await wo.select()
-    console.log('select all', ss)
-
-    //select
-    let so = await wo.select({ id: 'id-rosemary' })
-    console.log('select', so)
-
-    //select by $and, $gt, $lt
-    let spa = await wo.select({ '$and': [{ value: { '$gt': 123 } }, { value: { '$lt': 200 } }] })
-    console.log('select by $and, $gt, $lt', spa)
-
-    //select by $or, $gte, $lte
-    let spb = await wo.select({ '$or': [{ value: { '$lte': -1 } }, { value: { '$gte': 200 } }] })
-    console.log('select by $or, $gte, $lte', spb)
-
-    //select by $or, $and, $ne, $in, $nin
-    let spc = await wo.select({ '$or': [{ '$and': [{ value: { '$ne': 123 } }, { value: { '$in': [123, 321, 123.456, 456] } }, { value: { '$nin': [456, 654] } }] }, { '$or': [{ value: { '$lte': -1 } }, { value: { '$gte': 400 } }] }] })
-    console.log('select by $or, $and, $ne, $in, $nin', spc)
-
-    // //select by regex //mingo不支援regex
-    // 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'
-    })
-    await wo.del(d)
-        .then(function(msg) {
-            console.log('del then', msg)
-        })
-        .catch(function(msg) {
-            console.log('del catch', msg)
-        })
-
-}
-test()
-// change delAll
-// delAll then { n: 2, nDeleted: 2, ok: 1 }
-// change insert
-// insert then { n: 3, nInserted: 3, ok: 1 }
-// change save
-// save then [
-//   { n: 1, nModified: 1, ok: 1 },
-//   { n: 1, nModified: 1, ok: 1 },
-//   { n: 0, nModified: 0, ok: 1 }
-// ]
-// select all [
-//   { id: 'id-peter', name: 'peter(modify)', value: 123 },
-//   { id: 'id-rosemary', name: 'rosemary(modify)', value: 123.456 },
-//   {
-//     id: {random id},
-//     name: 'kettle',
-//     value: 456
-//   }
-// ]
-// select [ { id: 'id-rosemary', name: 'rosemary(modify)', value: 123.456 } ]
-// select by $and, $gt, $lt [ { id: 'id-rosemary', name: 'rosemary(modify)', value: 123.456 } ]
-// select by $or, $gte, $lte [
-//   {
-//     id: {random id},
-//     name: 'kettle',
-//     value: 456
-//   }
-// ]
-// select by $or, $and, $ne, $in, $nin [
-//   {
-//     id: 'id-rosemary',
-//     name: 'rosemary(modify)',
-//     value: 123.456
-//   },
-//   {
-//     id: {random id},
-//     name: 'kettle',
-//     value: 456
-//   }
-// ]
-// change save
-// save then [ { n: 1, nModified: 1, ok: 1 } ]
-// change del
-// del then [ { n: 1, nDeleted: 1, ok: 1 } ]
-
-
-//node g-basic.mjs
+import WOrm from './src/WOrmLowdb.mjs'
+//import WOrm from './dist/w-orm-lowdb.umd.js'
+// import w from 'wsemi'
+
+
+// w.fsDeleteFile('./db.json')
+
+let opt = {
+    url: './db.json',
+    db: 'worm',
+    cl: 'users',
+}
+
+let rs = [
+    {
+        id: 'id-peter',
+        name: 'peter',
+        value: 123,
+    },
+    {
+        id: 'id-rosemary',
+        name: 'rosemary',
+        value: 123.456,
+    },
+    {
+        id: '',
+        name: 'kettle',
+        value: 456,
+    },
+]
+
+let rsm = [
+    {
+        id: 'id-peter',
+        name: 'peter(modify)'
+    },
+    {
+        id: 'id-rosemary',
+        name: 'rosemary(modify)'
+    },
+    {
+        id: '',
+        name: 'kettle(modify)'
+    },
+]
+
+let rsa = [
+    {
+        id: 'id-rosemary',
+        name: 'rosemary',
+        value: 654.321,
+    },
+]
+
+async function test() {
+
+    //wo
+    let wo = WOrm(opt)
+
+    //on
+    wo.on('change', function(mode, data, res) {
+        console.log('change', mode)
+    })
+    wo.on('error', function(mode, data, err) {
+        console.log('error', mode, err)
+    })
+
+    //delAll
+    await wo.delAll()
+        .then(function(msg) {
+            console.log('delAll then', msg)
+        })
+        .catch(function(msg) {
+            console.log('delAll catch', msg)
+        })
+
+    //insert
+    await wo.insert(rs)
+        .then(function(msg) {
+            console.log('insert then', msg)
+        })
+        .catch(function(msg) {
+            console.log('insert catch', msg)
+        })
+
+    //insert by returnList, 回傳與輸入等長保序之逐筆結果, nInserted為1即該筆為新增
+    await wo.insert([{ id: 'id-peter' }, { id: 'id-new' }], { returnList: true })
+        .then(function(msg) {
+            console.log('insert(returnList) then', msg)
+        })
+        .catch(function(msg) {
+            console.log('insert(returnList) catch', msg)
+        })
+
+    //insertBulk, 全有全無, 任一筆主鍵已存在即整批reject且不寫入任何一筆
+    await wo.insertBulk([{ id: 'id-bulk1' }, { id: 'id-bulk2' }])
+        .then(function(msg) {
+            console.log('insertBulk then', msg)
+        })
+        .catch(function(msg) {
+            console.log('insertBulk catch', msg.toString())
+        })
+
+    //insertBulk by existed id
+    await wo.insertBulk([{ id: 'id-bulk3' }, { id: 'id-peter' }])
+        .then(function(msg) {
+            console.log('insertBulk(existed) then', msg)
+        })
+        .catch(function(msg) {
+            console.log('insertBulk(existed) catch', msg.toString())
+        })
+
+    //save
+    await wo.save(rsm, { autoInsert: false })
+        .then(function(msg) {
+            console.log('save then', msg)
+        })
+        .catch(function(msg) {
+            console.log('save catch', msg)
+        })
+
+    //selectByPk
+    let sp = await wo.selectByPk('id-rosemary')
+    console.log('selectByPk', sp)
+
+    //selectByPk by non-existed id
+    let spn = await wo.selectByPk('id-non-existed')
+    console.log('selectByPk(non-existed)', spn)
+
+    //del by id-new, id-bulk1, id-bulk2
+    await wo.del([{ id: 'id-new' }, { id: 'id-bulk1' }, { id: 'id-bulk2' }])
+        .then(function(msg) {
+            console.log('del(clean) then', msg)
+        })
+        .catch(function(msg) {
+            console.log('del(clean) catch', msg)
+        })
+
+    //select all
+    let ss = await wo.select()
+    console.log('select all', ss)
+
+    //select
+    let so = await wo.select({ id: 'id-rosemary' })
+    console.log('select', so)
+
+    //select by $and, $gt, $lt
+    let spa = await wo.select({ '$and': [{ value: { '$gt': 123 } }, { value: { '$lt': 200 } }] })
+    console.log('select by $and, $gt, $lt', spa)
+
+    //select by $or, $gte, $lte
+    let spb = await wo.select({ '$or': [{ value: { '$lte': -1 } }, { value: { '$gte': 200 } }] })
+    console.log('select by $or, $gte, $lte', spb)
+
+    //select by $or, $and, $ne, $in, $nin
+    let spc = await wo.select({ '$or': [{ '$and': [{ value: { '$ne': 123 } }, { value: { '$in': [123, 321, 123.456, 456] } }, { value: { '$nin': [456, 654] } }] }, { '$or': [{ value: { '$lte': -1 } }, { value: { '$gte': 400 } }] }] })
+    console.log('select by $or, $and, $ne, $in, $nin', spc)
+
+    // //select by regex //mingo不支援regex
+    // 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'
+    })
+    await wo.del(d)
+        .then(function(msg) {
+            console.log('del then', msg)
+        })
+        .catch(function(msg) {
+            console.log('del catch', msg)
+        })
+
+    //del by invalid id, 未帶有效主鍵者為該筆ok為0並附err, 整批仍resolve
+    await wo.del([{ name: 'no-id' }])
+        .then(function(msg) {
+            console.log('del(invalid id) then', msg)
+        })
+        .catch(function(msg) {
+            console.log('del(invalid id) catch', msg)
+        })
+
+    //delAll by find
+    await wo.delAll({ value: { '$gte': 600 } })
+        .then(function(msg) {
+            console.log('delAll(find) then', msg)
+        })
+        .catch(function(msg) {
+            console.log('delAll(find) catch', msg)
+        })
+
+}
+test()

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "w-orm-lowdb",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "main": "dist/w-orm-lowdb.umd.js",
   "dependencies": {
     "lowdb": "^7.0.1",
-    "mingo": "^7.2.1",
+    "mingo": "^7.2.4",
     "wsemi": "^1.8.70"
   },
   "devDependencies": {