w-orm-lowdb 1.0.32 → 1.0.34

package/test/lib/leaves.mjs

@@ -0,0 +1,46 @@
+import assert from 'assert'
+
+
+//呼叫端傳入物件之逐節點快照(unit-find-whitelist與unit-date-write共用, 只定義一處)
+
+//timeOf, 以內部槽取Date之時間值, 非Date回傳undefined(跨realm、子類別、被改Symbol.toStringTag之Date皆可辨)
+let timeOf = (v) => {
+    try {
+        return Date.prototype.getTime.call(v)
+    }
+    catch (err) {
+        return undefined
+    }
+}
+
+//leaves: 取物件之全部節點(物件節點記鍵序,Date節點記毫秒,皆記參照), 供reject後確認呼叫端實際傳入之同一物件逐節點未被改動; 物件須為無環
+let leaves = (v, p = 'root', out = []) => {
+    let ms = timeOf(v)
+    if (ms !== undefined) {
+        out.push({ p, ref: v, ms })
+    }
+    else if (v !== null && typeof v === 'object') {
+        out.push({ p, ref: v, keys: Object.keys(v).join(',') })
+        for (let k of Object.keys(v)) {
+            leaves(v[k], `${p}.${k}`, out)
+        }
+    }
+    else {
+        out.push({ p, ref: v })
+    }
+    return out
+}
+
+//chkSame: 兩次leaves之結果須逐節點相同(參照、毫秒、鍵序)
+let chkSame = (a, b) => {
+    assert.strict.equal(a.length, b.length, 'object should keep the same number of nodes')
+    for (let i = 0; i < a.length; i++) {
+        assert.strict.equal(a[i].p, b[i].p)
+        assert.strict.equal(a[i].ref, b[i].ref, `${a[i].p} should keep the same reference or value`)
+        assert.strict.equal(a[i].ms, b[i].ms, `${a[i].p} should keep the same time value`)
+        assert.strict.equal(a[i].keys, b[i].keys, `${a[i].p} should keep the same keys`)
+    }
+}
+
+
+export { timeOf, leaves, chkSame }

package/test/lib/mkObserver.mjs

@@ -0,0 +1,52 @@
+//呼叫觀測器(unit-find-whitelist與unit-date-write共用, 只定義一處)
+
+//tick, 讓出一個macrotask, 令延遲發出之事件有機會發出
+let tick = () => new Promise((resolve) => setTimeout(resolve, 0))
+
+//mkObserver, 建立呼叫觀測器: 事件記錄於evs, 每筆error事件附帶發出當下呼叫端之await是否已恢復(settledAtEmit, 即呼叫端可觀察之先後)
+let mkObserver = (wo) => {
+    let evs = []
+    let cur = { settled: false }
+    wo.on('error', function(mode, data, err) {
+        evs.push({ t: 'error', mode, data, err, settledAtEmit: cur.settled })
+    })
+    wo.on('change', function(mode) {
+        evs.push({ t: 'change', mode })
+    })
+
+    //run, 執行call()(回傳Promise之函數)並回傳{ ok, val, err, nAtSettle, probe, evs }, nAtSettle為結果定案當下之事件數,
+    //probe為結果定案當下(同一microtask鏈內, 尚未讓出macrotask)呼叫probeFn()之回傳, evs為再讓出一個macrotask後之事件
+    let run = async(call, probeFn = null) => {
+        evs.length = 0
+        cur = { settled: false }
+        let out = { ok: false, val: null, err: null, nAtSettle: 0, probe: null, evs: [] }
+        try {
+            out.val = await call()
+            out.ok = true
+        }
+        catch (err) {
+            out.err = err
+        }
+        cur.settled = true
+        out.nAtSettle = evs.length
+        out.probe = probeFn ? probeFn() : null
+        await tick()
+        out.evs = evs.slice()
+        return out
+    }
+
+    //invoke, 呼叫wo[fn](arg)
+    let invoke = (fn, arg, probeFn = null) => {
+        return run(() => wo[fn](arg), probeFn)
+    }
+
+    //clear
+    let clear = () => {
+        evs.length = 0
+    }
+
+    return { run, invoke, clear }
+}
+
+
+export { tick, mkObserver }