w-orm-lowdb 1.0.12 → 1.0.14

package/test/unit-insertbulk.test.mjs

@@ -0,0 +1,188 @@
+import assert from 'assert'
+import _ from 'lodash-es'
+import w from 'wsemi'
+import WOrm from '../src/WOrmLowdb.mjs'
+
+
+describe('insertBulk', function() {
+    let rt = null
+    let vans = {}
+    let vget = {}
+
+    before(async function() {
+
+        w.fsDeleteFile('./db_insertbulk.json')
+
+        let wo = WOrm({ url: './db_insertbulk.json', db: 'worm', cl: 'users' })
+
+        //輸入無效, 回傳空結果而非錯誤, 且鍵集合與insert完全相同
+        vget[1] = await wo.insertBulk(null)
+
+        //正常插入, nInserted須恆等於n
+        rt = null
+        await wo.insertBulk([{ id: 'a' }, { id: 'b' }, { id: 'c' }])
+            .then(function(msg) {
+                rt = msg
+            })
+            .catch(function(msg) {
+                rt = 'reject: ' + msg.toString()
+            })
+        vget[2] = rt
+        vget[3] = _.map(_.sortBy(await wo.select(), 'id'), 'id')
+
+        //單一物件亦須回傳單一物件而非陣列
+        vget[4] = await wo.insertBulk({ id: 'd' })
+
+        //含既有主鍵須整批reject, 且不得寫入任何一筆
+        let n1 = _.size(await wo.select())
+        rt = null
+        await wo.insertBulk([{ id: 'e' }, { id: 'a' }, { id: 'f' }])
+            .then(function(msg) {
+                rt = 'resolve: ' + JSON.stringify(msg)
+            })
+            .catch(function() {
+                rt = 'reject'
+            })
+        vget[5] = rt
+        let n2 = _.size(await wo.select())
+        vget[6] = n2 - n1
+        vget[7] = [await wo.selectByPk('e'), await wo.selectByPk('f')]
+
+        //同批含重複主鍵須整批reject, 且不得寫入任何一筆
+        rt = null
+        await wo.insertBulk([{ id: 'g' }, { id: 'h' }, { id: 'g' }])
+            .then(function(msg) {
+                rt = 'resolve: ' + JSON.stringify(msg)
+            })
+            .catch(function() {
+                rt = 'reject'
+            })
+        vget[8] = rt
+        vget[9] = _.size(await wo.select()) - n2
+        vget[10] = [await wo.selectByPk('g'), await wo.selectByPk('h')]
+
+        //大批次末筆衝突亦不得留下部份寫入
+        let n3 = _.size(await wo.select())
+        let dt = _.map(_.range(200), function(v) {
+            return { id: `bulk-${v}` }
+        })
+        dt.push({ id: 'a' })
+        rt = null
+        await wo.insertBulk(dt)
+            .then(function(msg) {
+                rt = 'resolve: ' + JSON.stringify(msg)
+            })
+            .catch(function() {
+                rt = 'reject'
+            })
+        vget[11] = rt
+        vget[12] = _.size(await wo.select()) - n3
+
+        //衝突後既有數據不得被改動
+        vget[13] = await wo.selectByPk('a')
+
+        //無衝突之大批次須全數寫入
+        vget[14] = await wo.insertBulk(_.map(_.range(200), function(v) {
+            return { id: `ok-${v}`, v }
+        }))
+        vget[15] = _.size(await wo.select()) - n3
+
+        //autoGenPk為true時未帶主鍵者由套件補值
+        let r = await wo.insertBulk([{ name: 'auto1' }, { name: 'auto2' }])
+        vget[16] = r
+        vget[17] = _.size(_.filter(await wo.select(), function(v) {
+            return _.startsWith(v.name, 'auto')
+        }))
+
+    })
+
+    after(async function() {
+        w.fsDeleteFile('./db_insertbulk.json')
+    })
+
+    vans[1] = { n: 0, nInserted: 0, ok: 1 }
+    it(`should get ${JSON.stringify(vans[1])} for insertBulk(null)`, async function() {
+        assert.strict.deepStrictEqual(vget[1], vans[1])
+    })
+
+    vans[2] = { n: 3, nInserted: 3, ok: 1 }
+    it(`should get ${JSON.stringify(vans[2])} for insertBulk 3 rows`, async function() {
+        assert.strict.deepStrictEqual(vget[2], vans[2])
+    })
+
+    vans[3] = ['a', 'b', 'c']
+    it(`should get ${JSON.stringify(vans[3])} for all ids after insertBulk`, async function() {
+        assert.strict.deepStrictEqual(vget[3], vans[3])
+    })
+
+    vans[4] = { n: 1, nInserted: 1, ok: 1 }
+    it(`should get ${JSON.stringify(vans[4])} for insertBulk single object`, async function() {
+        assert.strict.deepStrictEqual(vget[4], vans[4])
+    })
+
+    vans[5] = 'reject'
+    it(`should get ${JSON.stringify(vans[5])} for insertBulk with existed pk`, async function() {
+        assert.strict.deepStrictEqual(vget[5], vans[5])
+    })
+
+    vans[6] = 0
+    it(`should get ${JSON.stringify(vans[6])} for increment of rows after conflict`, async function() {
+        assert.strict.deepStrictEqual(vget[6], vans[6])
+    })
+
+    vans[7] = [null, null]
+    it(`should get ${JSON.stringify(vans[7])} for rows before and after the conflicted one`, async function() {
+        assert.strict.deepStrictEqual(vget[7], vans[7])
+    })
+
+    vans[8] = 'reject'
+    it(`should get ${JSON.stringify(vans[8])} for insertBulk with duplicated pk in same batch`, async function() {
+        assert.strict.deepStrictEqual(vget[8], vans[8])
+    })
+
+    vans[9] = 0
+    it(`should get ${JSON.stringify(vans[9])} for increment of rows after duplicated pk`, async function() {
+        assert.strict.deepStrictEqual(vget[9], vans[9])
+    })
+
+    vans[10] = [null, null]
+    it(`should get ${JSON.stringify(vans[10])} for rows of duplicated batch`, async function() {
+        assert.strict.deepStrictEqual(vget[10], vans[10])
+    })
+
+    vans[11] = 'reject'
+    it(`should get ${JSON.stringify(vans[11])} for insertBulk 201 rows with conflict at last`, async function() {
+        assert.strict.deepStrictEqual(vget[11], vans[11])
+    })
+
+    vans[12] = 0
+    it(`should get ${JSON.stringify(vans[12])} for increment of rows after large batch conflict`, async function() {
+        assert.strict.deepStrictEqual(vget[12], vans[12])
+    })
+
+    vans[13] = { id: 'a' }
+    it(`should get ${JSON.stringify(vans[13])} for existed row after conflict`, async function() {
+        assert.strict.deepStrictEqual(vget[13], vans[13])
+    })
+
+    vans[14] = { n: 200, nInserted: 200, ok: 1 }
+    it(`should get ${JSON.stringify(vans[14])} for insertBulk 200 rows without conflict`, async function() {
+        assert.strict.deepStrictEqual(vget[14], vans[14])
+    })
+
+    vans[15] = 200
+    it(`should get ${JSON.stringify(vans[15])} for increment of rows after large batch success`, async function() {
+        assert.strict.deepStrictEqual(vget[15], vans[15])
+    })
+
+    vans[16] = { n: 2, nInserted: 2, ok: 1 }
+    it(`should get ${JSON.stringify(vans[16])} for insertBulk without pk when autoGenPk=true`, async function() {
+        assert.strict.deepStrictEqual(vget[16], vans[16])
+    })
+
+    vans[17] = 2
+    it(`should get ${JSON.stringify(vans[17])} for count of auto generated pk rows`, async function() {
+        assert.strict.deepStrictEqual(vget[17], vans[17])
+    })
+
+})

package/test/unit-returnlist.test.mjs

@@ -0,0 +1,159 @@
+import assert from 'assert'
+import _ from 'lodash-es'
+import w from 'wsemi'
+import WOrm from '../src/WOrmLowdb.mjs'
+
+
+describe('returnList', function() {
+    let rt = null
+    let vans = {}
+    let vget = {}
+
+    before(async function() {
+
+        w.fsDeleteFile('./db_returnlist.json')
+
+        let wo = WOrm({ url: './db_returnlist.json', db: 'worm', cl: 'users' })
+
+        //既有數據
+        await wo.insert([{ id: 'a' }, { id: 'b' }])
+
+        //returnList未給時為聚合物件, 形狀由呼叫點靜態決定
+        vget[1] = await wo.insert([{ id: 'a' }, { id: 'c' }])
+
+        //returnList為false時同上
+        vget[2] = await wo.insert([{ id: 'a' }, { id: 'd' }], { returnList: false })
+
+        //returnList為true時回傳與輸入等長保序之逐筆陣列, 且對位正確
+        let dt = [{ id: 'a' }, { id: 'e' }, { id: 'b' }, { id: 'f' }]
+        vget[3] = await wo.insert(dt, { returnList: true })
+        vget[4] = _.size(vget[3]) === _.size(dt)
+
+        //逐筆元素之鍵集合恰為{n, nInserted, ok}
+        vget[5] = _.uniq(_.map(vget[3], function(v) {
+            return _.keys(v).sort().join(',')
+        }))
+
+        //逐筆之n恆為1, ok恆為1
+        vget[6] = _.uniq(_.map(vget[3], 'n'))
+        vget[7] = _.uniq(_.map(vget[3], 'ok'))
+
+        //同批含重複主鍵時僅首筆之nInserted為1
+        vget[8] = _.map(await wo.insert([{ id: 'g' }, { id: 'g' }, { id: 'g' }], { returnList: true }), 'nInserted')
+
+        //filter計數等於聚合模式之nInserted
+        await wo.delAll()
+        await wo.insert([{ id: 'x1' }, { id: 'x2' }])
+        let dtc = [{ id: 'x1' }, { id: 'x3' }, { id: 'x2' }, { id: 'x4' }, { id: 'x3' }]
+        let rl = await wo.insert(dtc, { returnList: true })
+        await wo.delAll()
+        await wo.insert([{ id: 'x1' }, { id: 'x2' }])
+        let ra = await wo.insert(dtc)
+        vget[9] = [
+            _.size(_.filter(rl, function(v) {
+                return v.nInserted === 1
+            })),
+            ra.nInserted,
+        ]
+
+        //輸入無效時回傳空陣列
+        vget[10] = await wo.insert(null, { returnList: true })
+        vget[11] = await wo.insert([], { returnList: true })
+
+        //change事件之res即本次實際回傳值
+        let evs = []
+        wo.on('change', function(mode, data, res) {
+            evs.push({ mode, res })
+        })
+        let rr = await wo.insert([{ id: 'y1' }, { id: 'y2' }], { returnList: true })
+        vget[12] = _.isEqual(_.get(evs, '0.res'), rr)
+
+        //autoGenPk為false且未帶主鍵時仍為整批reject, 不因本選項降為逐筆
+        let wof = WOrm({ url: './db_returnlist.json', db: 'worm', cl: 'nopk', autoGenPk: false })
+        rt = null
+        await wof.insert([{ id: 'z1' }, { name: 'no-id' }], { returnList: true })
+            .then(function(msg) {
+                rt = 'resolve: ' + JSON.stringify(msg)
+            })
+            .catch(function() {
+                rt = 'reject'
+            })
+        vget[13] = rt
+
+    })
+
+    after(async function() {
+        w.fsDeleteFile('./db_returnlist.json')
+    })
+
+    vans[1] = { n: 2, nInserted: 1, ok: 1 }
+    it(`should get ${JSON.stringify(vans[1])} for insert without returnList`, async function() {
+        assert.strict.deepStrictEqual(vget[1], vans[1])
+    })
+
+    vans[2] = { n: 2, nInserted: 1, ok: 1 }
+    it(`should get ${JSON.stringify(vans[2])} for insert with returnList=false`, async function() {
+        assert.strict.deepStrictEqual(vget[2], vans[2])
+    })
+
+    vans[3] = [
+        { n: 1, nInserted: 0, ok: 1 },
+        { n: 1, nInserted: 1, ok: 1 },
+        { n: 1, nInserted: 0, ok: 1 },
+        { n: 1, nInserted: 1, ok: 1 },
+    ]
+    it(`should get ${JSON.stringify(vans[3])} for insert with returnList=true`, async function() {
+        assert.strict.deepStrictEqual(vget[3], vans[3])
+    })
+
+    vans[4] = true
+    it(`should get ${JSON.stringify(vans[4])} for length of returnList equal to input`, async function() {
+        assert.strict.deepStrictEqual(vget[4], vans[4])
+    })
+
+    vans[5] = ['n,nInserted,ok']
+    it(`should get ${JSON.stringify(vans[5])} for keys of each item`, async function() {
+        assert.strict.deepStrictEqual(vget[5], vans[5])
+    })
+
+    vans[6] = [1]
+    it(`should get ${JSON.stringify(vans[6])} for n of each item`, async function() {
+        assert.strict.deepStrictEqual(vget[6], vans[6])
+    })
+
+    vans[7] = [1]
+    it(`should get ${JSON.stringify(vans[7])} for ok of each item`, async function() {
+        assert.strict.deepStrictEqual(vget[7], vans[7])
+    })
+
+    vans[8] = [1, 0, 0]
+    it(`should get ${JSON.stringify(vans[8])} for nInserted of duplicated pk in same batch`, async function() {
+        assert.strict.deepStrictEqual(vget[8], vans[8])
+    })
+
+    vans[9] = [2, 2]
+    it(`should get ${JSON.stringify(vans[9])} for filtered count and aggregated nInserted`, async function() {
+        assert.strict.deepStrictEqual(vget[9], vans[9])
+    })
+
+    vans[10] = []
+    it(`should get ${JSON.stringify(vans[10])} for insert(null) with returnList=true`, async function() {
+        assert.strict.deepStrictEqual(vget[10], vans[10])
+    })
+
+    vans[11] = []
+    it(`should get ${JSON.stringify(vans[11])} for insert([]) with returnList=true`, async function() {
+        assert.strict.deepStrictEqual(vget[11], vans[11])
+    })
+
+    vans[12] = true
+    it(`should get ${JSON.stringify(vans[12])} for res of change event equal to returned value`, async function() {
+        assert.strict.deepStrictEqual(vget[12], vans[12])
+    })
+
+    vans[13] = 'reject'
+    it(`should get ${JSON.stringify(vans[13])} for insert with returnList=true and autoGenPk=false without pk`, async function() {
+        assert.strict.deepStrictEqual(vget[13], vans[13])
+    })
+
+})

package/test/unit-save.test.mjs

@@ -0,0 +1,199 @@
+import assert from 'assert'
+import _ from 'lodash-es'
+import w from 'wsemi'
+import WOrm from '../src/WOrmLowdb.mjs'
+
+
+describe('save', function() {
+    let vans = {}
+    let vget = {}
+
+    before(async function() {
+
+        w.fsDeleteFile('./db_save.json')
+
+        let wo = WOrm({ url: './db_save.json', db: 'worm', cl: 'users' })
+
+        //輸入無效, 回傳空陣列
+        vget[1] = await wo.save(null)
+        vget[2] = await wo.save([])
+
+        //既有數據
+        await wo.insert([
+            { id: 'a', name: 'peter', value: 123, ext: { x: 1, y: 2 } },
+            { id: 'b', name: 'rosemary', value: 456 },
+        ])
+
+        //主鍵存在, 合併後內容有變更
+        vget[3] = await wo.save({ id: 'a', name: 'peter(modify)' })
+        vget[4] = await wo.selectByPk('a')
+
+        //主鍵存在, 合併後內容與現值相同而未寫入(整筆相同)
+        vget[5] = await wo.save({ id: 'a', name: 'peter(modify)', value: 123, ext: { x: 1, y: 2 } })
+
+        //主鍵存在, 只給部份欄位且值皆與現值相同, 合併結果等於現值故nModified為0
+        vget[6] = await wo.save({ id: 'a', value: 123 })
+
+        //主鍵存在, 只給部份欄位且值不同, 未給之欄位須保留
+        vget[7] = await wo.save({ id: 'a', value: 999 })
+        vget[8] = await wo.selectByPk('a')
+
+        //深層合併: 巢狀物件僅給部份鍵時, 其餘鍵須保留
+        vget[9] = await wo.save({ id: 'a', ext: { x: 9 } })
+        vget[10] = await wo.selectByPk('a')
+
+        //深層合併後與現值相同者, nModified為0
+        vget[11] = await wo.save({ id: 'a', ext: { y: 2 } })
+
+        //主鍵不存在, autoInsert預設為true則插入
+        vget[12] = await wo.save({ id: 'c', name: 'kettle' })
+        vget[13] = await wo.selectByPk('c')
+
+        //主鍵不存在, autoInsert為false則不插入且n為0
+        vget[14] = await wo.save({ id: 'd', name: 'nobody' }, { autoInsert: false })
+        vget[15] = await wo.selectByPk('d')
+
+        //單一物件亦回傳長度為1之陣列
+        vget[16] = _.isArray(vget[12]) && _.size(vget[12]) === 1
+
+        //逐筆結果之鍵集合恆為{n, nInserted, nModified, ok}
+        let rs = await wo.save([
+            { id: 'a', value: 1000 }, //更新
+            { id: 'b', value: 456 }, //內容相同
+            { id: 'e', value: 1 }, //插入
+        ])
+        vget[17] = rs
+        vget[18] = _.uniq(_.map(rs, function(v) {
+            return _.keys(v).sort().join(',')
+        }))
+
+        //與輸入等長保序
+        vget[19] = _.size(rs)
+
+        //autoGenPk為true時未帶主鍵者由套件補值後插入
+        let ra = await wo.save({ name: 'auto' })
+        vget[20] = ra
+        vget[21] = _.size(_.filter(await wo.select(), function(v) {
+            return v.name === 'auto'
+        }))
+
+        //註: save之逐筆失敗路徑(ok為0)於本套件不可達, 因逐筆處理皆為記憶體內之比對與合併而不拋錯,
+        //讀檔與寫檔之失敗影響全部筆數而屬整批性錯誤, 依規格以reject回報而不降為逐筆
+        //[單筆失敗不中斷整批]之可達情形見unit-del之未帶有效主鍵
+
+    })
+
+    after(async function() {
+        w.fsDeleteFile('./db_save.json')
+    })
+
+    vans[1] = []
+    it(`should get ${JSON.stringify(vans[1])} for save(null)`, async function() {
+        assert.strict.deepStrictEqual(vget[1], vans[1])
+    })
+
+    vans[2] = []
+    it(`should get ${JSON.stringify(vans[2])} for save([])`, async function() {
+        assert.strict.deepStrictEqual(vget[2], vans[2])
+    })
+
+    vans[3] = [{ n: 1, nInserted: 0, nModified: 1, ok: 1 }]
+    it(`should get ${JSON.stringify(vans[3])} for save with modified content`, async function() {
+        assert.strict.deepStrictEqual(vget[3], vans[3])
+    })
+
+    vans[4] = { id: 'a', name: 'peter(modify)', value: 123, ext: { x: 1, y: 2 } }
+    it(`should get ${JSON.stringify(vans[4])} for row after save`, async function() {
+        assert.strict.deepStrictEqual(vget[4], vans[4])
+    })
+
+    vans[5] = [{ n: 1, nInserted: 0, nModified: 0, ok: 1 }]
+    it(`should get ${JSON.stringify(vans[5])} for save with same content`, async function() {
+        assert.strict.deepStrictEqual(vget[5], vans[5])
+    })
+
+    vans[6] = [{ n: 1, nInserted: 0, nModified: 0, ok: 1 }]
+    it(`should get ${JSON.stringify(vans[6])} for save with partial fields and same values`, async function() {
+        assert.strict.deepStrictEqual(vget[6], vans[6])
+    })
+
+    vans[7] = [{ n: 1, nInserted: 0, nModified: 1, ok: 1 }]
+    it(`should get ${JSON.stringify(vans[7])} for save with partial fields and different values`, async function() {
+        assert.strict.deepStrictEqual(vget[7], vans[7])
+    })
+
+    vans[8] = { id: 'a', name: 'peter(modify)', value: 999, ext: { x: 1, y: 2 } }
+    it(`should get ${JSON.stringify(vans[8])} for row keeping fields which not given`, async function() {
+        assert.strict.deepStrictEqual(vget[8], vans[8])
+    })
+
+    vans[9] = [{ n: 1, nInserted: 0, nModified: 1, ok: 1 }]
+    it(`should get ${JSON.stringify(vans[9])} for save with partial keys of nested object`, async function() {
+        assert.strict.deepStrictEqual(vget[9], vans[9])
+    })
+
+    vans[10] = { id: 'a', name: 'peter(modify)', value: 999, ext: { x: 9, y: 2 } }
+    it(`should get ${JSON.stringify(vans[10])} for row after deep merge`, async function() {
+        assert.strict.deepStrictEqual(vget[10], vans[10])
+    })
+
+    vans[11] = [{ n: 1, nInserted: 0, nModified: 0, ok: 1 }]
+    it(`should get ${JSON.stringify(vans[11])} for save with nested object and same values`, async function() {
+        assert.strict.deepStrictEqual(vget[11], vans[11])
+    })
+
+    vans[12] = [{ n: 1, nInserted: 1, nModified: 0, ok: 1 }]
+    it(`should get ${JSON.stringify(vans[12])} for save with autoInsert=true and pk not existed`, async function() {
+        assert.strict.deepStrictEqual(vget[12], vans[12])
+    })
+
+    vans[13] = { id: 'c', name: 'kettle' }
+    it(`should get ${JSON.stringify(vans[13])} for row inserted by save`, async function() {
+        assert.strict.deepStrictEqual(vget[13], vans[13])
+    })
+
+    vans[14] = [{ n: 0, nInserted: 0, nModified: 0, ok: 1 }]
+    it(`should get ${JSON.stringify(vans[14])} for save with autoInsert=false and pk not existed`, async function() {
+        assert.strict.deepStrictEqual(vget[14], vans[14])
+    })
+
+    vans[15] = null
+    it(`should get ${JSON.stringify(vans[15])} for row not inserted by save with autoInsert=false`, async function() {
+        assert.strict.deepStrictEqual(vget[15], vans[15])
+    })
+
+    vans[16] = true
+    it(`should get ${JSON.stringify(vans[16])} for save single object returning array with length 1`, async function() {
+        assert.strict.deepStrictEqual(vget[16], vans[16])
+    })
+
+    vans[17] = [
+        { n: 1, nInserted: 0, nModified: 1, ok: 1 },
+        { n: 1, nInserted: 0, nModified: 0, ok: 1 },
+        { n: 1, nInserted: 1, nModified: 0, ok: 1 },
+    ]
+    it(`should get ${JSON.stringify(vans[17])} for save with mixed cases`, async function() {
+        assert.strict.deepStrictEqual(vget[17], vans[17])
+    })
+
+    vans[18] = ['n,nInserted,nModified,ok']
+    it(`should get ${JSON.stringify(vans[18])} for keys of each item`, async function() {
+        assert.strict.deepStrictEqual(vget[18], vans[18])
+    })
+
+    vans[19] = 3
+    it(`should get ${JSON.stringify(vans[19])} for length of result equal to input`, async function() {
+        assert.strict.deepStrictEqual(vget[19], vans[19])
+    })
+
+    vans[20] = [{ n: 1, nInserted: 1, nModified: 0, ok: 1 }]
+    it(`should get ${JSON.stringify(vans[20])} for save without pk when autoGenPk=true`, async function() {
+        assert.strict.deepStrictEqual(vget[20], vans[20])
+    })
+
+    vans[21] = 1
+    it(`should get ${JSON.stringify(vans[21])} for count of auto generated pk row`, async function() {
+        assert.strict.deepStrictEqual(vget[21], vans[21])
+    })
+
+})

package/test/unit-selectbypk.test.mjs

@@ -0,0 +1,121 @@
+import assert from 'assert'
+import _ from 'lodash-es'
+import w from 'wsemi'
+import WOrm from '../src/WOrmLowdb.mjs'
+
+
+describe('selectByPk', function() {
+    let vans = {}
+    let vget = {}
+
+    before(async function() {
+
+        w.fsDeleteFile('./db_selectbypk.json')
+
+        let wo = WOrm({ url: './db_selectbypk.json', db: 'worm', cl: 'users' })
+
+        await wo.insert([
+            { id: 'id-peter', name: 'peter', value: 123 },
+            { id: 'id-rosemary', name: 'rosemary', value: 123.456 },
+        ])
+
+        //主鍵命中, 回傳該筆數據物件
+        vget[1] = await wo.selectByPk('id-peter')
+
+        //主鍵命中者之內容須與select({主鍵})[0]相同
+        let vs = await wo.select({ id: 'id-peter' })
+        vget[2] = _.isEqual(vget[1], _.get(vs, 0))
+
+        //主鍵未命中, 回傳null而非undefined或空陣列
+        vget[3] = await wo.selectByPk('id-not-existed')
+
+        //主鍵值無效(未給), 回傳null且不reject
+        let rt = null
+        await wo.selectByPk()
+            .then(function(msg) {
+                rt = msg
+            })
+            .catch(function(msg) {
+                rt = 'reject: ' + msg.toString()
+            })
+        vget[4] = rt
+
+        //主鍵值無效(型別不符), 回傳null且不reject
+        rt = null
+        await wo.selectByPk(123)
+            .then(function(msg) {
+                rt = msg
+            })
+            .catch(function(msg) {
+                rt = 'reject: ' + msg.toString()
+            })
+        vget[5] = rt
+
+        //命中之判定基準須與insert一致: selectByPk回傳物件者, insert須視為已存在而不插入
+        let ri = await wo.insert({ id: 'id-peter', name: 'other' })
+        vget[6] = ri
+
+        //命中之判定基準須與del一致
+        let rd = await wo.del({ id: 'id-rosemary' })
+        vget[7] = rd
+        vget[8] = await wo.selectByPk('id-rosemary')
+
+        //讀取函數不得有副作用, 連續呼叫selectByPk後全表筆數不變
+        let n1 = _.size(await wo.select())
+        await wo.selectByPk('id-not-existed')
+        await wo.selectByPk('id-peter')
+        let n2 = _.size(await wo.select())
+        vget[9] = [n1, n2]
+
+    })
+
+    after(async function() {
+        w.fsDeleteFile('./db_selectbypk.json')
+    })
+
+    vans[1] = { id: 'id-peter', name: 'peter', value: 123 }
+    it(`should get ${JSON.stringify(vans[1])} for selectByPk with matched pk`, async function() {
+        assert.strict.deepStrictEqual(vget[1], vans[1])
+    })
+
+    vans[2] = true
+    it(`should get ${JSON.stringify(vans[2])} for selectByPk equal to select({pk})[0]`, async function() {
+        assert.strict.deepStrictEqual(vget[2], vans[2])
+    })
+
+    vans[3] = null
+    it(`should get ${JSON.stringify(vans[3])} for selectByPk with unmatched pk`, async function() {
+        assert.strict.deepStrictEqual(vget[3], vans[3])
+    })
+
+    vans[4] = null
+    it(`should get ${JSON.stringify(vans[4])} for selectByPk without pk`, async function() {
+        assert.strict.deepStrictEqual(vget[4], vans[4])
+    })
+
+    vans[5] = null
+    it(`should get ${JSON.stringify(vans[5])} for selectByPk with invalid pk type`, async function() {
+        assert.strict.deepStrictEqual(vget[5], vans[5])
+    })
+
+    vans[6] = { n: 1, nInserted: 0, ok: 1 }
+    it(`should get ${JSON.stringify(vans[6])} for insert with pk which selectByPk matched`, async function() {
+        assert.strict.deepStrictEqual(vget[6], vans[6])
+    })
+
+    vans[7] = [{ n: 1, nDeleted: 1, ok: 1 }]
+    it(`should get ${JSON.stringify(vans[7])} for del with pk which selectByPk matched`, async function() {
+        assert.strict.deepStrictEqual(vget[7], vans[7])
+    })
+
+    vans[8] = null
+    it(`should get ${JSON.stringify(vans[8])} for selectByPk after del`, async function() {
+        assert.strict.deepStrictEqual(vget[8], vans[8])
+    })
+
+    vans[9] = [1, 1]
+    it(`should get ${JSON.stringify(vans[9])} for size of table before and after selectByPk`, async function() {
+        assert.strict.deepStrictEqual(vget[9], vans[9])
+    })
+
+})

package/toolg/gDistRollup.mjs

@@ -7,17 +7,17 @@ let fdTar = './dist'
 
 
 rollupFiles({
-    fns: getFiles(fdSrc),
+    fns: 'WOrmLowdb.mjs',
     fdSrc,
     fdTar,
     nameDistType: 'kebabCase',
     globals: {
-        'events': 'events',
+        'path': 'path',
         'lowdb': 'lowdb',
         'mingo': 'mingo',
     },
     external: [
-        'events',
+        'path',
         'lowdb',
         'mingo',
     ],