w-orm-mongodb 1.1.38 → 1.1.39

package/docs/WOrmMongodb.mjs.html

@@ -29,7 +29,7 @@
 <nav >
     
     
-    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="WOrmMongodb.html">WOrmMongodb</a><ul class='methods'><li data-type='method'><a href="WOrmMongodb.html#.del">del</a></li><li data-type='method'><a href="WOrmMongodb.html#.delAll">delAll</a></li><li data-type='method'><a href="WOrmMongodb.html#.delAllGfs">delAllGfs</a></li><li data-type='method'><a href="WOrmMongodb.html#.delGfs">delGfs</a></li><li data-type='method'><a href="WOrmMongodb.html#.insert">insert</a></li><li data-type='method'><a href="WOrmMongodb.html#.insertGfs">insertGfs</a></li><li data-type='method'><a href="WOrmMongodb.html#.save">save</a></li><li data-type='method'><a href="WOrmMongodb.html#.select">select</a></li><li data-type='method'><a href="WOrmMongodb.html#.selectById">selectById</a></li><li data-type='method'><a href="WOrmMongodb.html#.selectByIdGfs">selectByIdGfs</a></li></ul></li></ul>
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="WOrmMongodb.html">WOrmMongodb</a><ul class='methods'><li data-type='method'><a href="WOrmMongodb.html#.del">del</a></li><li data-type='method'><a href="WOrmMongodb.html#.delAll">delAll</a></li><li data-type='method'><a href="WOrmMongodb.html#.delAllGfs">delAllGfs</a></li><li data-type='method'><a href="WOrmMongodb.html#.delGfs">delGfs</a></li><li data-type='method'><a href="WOrmMongodb.html#.insert">insert</a></li><li data-type='method'><a href="WOrmMongodb.html#.insertGfs">insertGfs</a></li><li data-type='method'><a href="WOrmMongodb.html#.save">save</a></li><li data-type='method'><a href="WOrmMongodb.html#.select">select</a></li><li data-type='method'><a href="WOrmMongodb.html#.selectByPk">selectByPk</a></li><li data-type='method'><a href="WOrmMongodb.html#.selectByPkGfs">selectByPkGfs</a></li></ul></li></ul>
     
 </nav>
 
@@ -67,6 +67,9 @@ import pmSeries from 'wsemi/src/pmSeries.mjs'
 /**
  * 操作資料庫(MongoDB)
  *
+ * 本套件之主鍵欄位固定為id，尚未支援由呼叫端指定。
+ * id為無業務語義之識別碼，故insert與save於輸入未帶有效id時自動補值；del不補值。
+ *
  * @class
  * @param {Object} [opt={}] 輸入設定物件，預設{}
  * @param {String} [opt.url='mongodb://127.0.0.1:27017'] 輸入連接資料庫字串，預設'mongodb://127.0.0.1:27017'
@@ -321,19 +324,20 @@ function WOrmMongodb(opt = {}) {
 
 
     /**
-     * 由id查詢單筆數據，因由MongoDB查找且僅回傳單筆，不需如select提取全部符合數據再處理，故數據量大時效能較佳
+     * 由主鍵查詢單筆數據，因由MongoDB查找且僅回傳單筆，不需如select提取全部符合數據再處理，故數據量大時效能較佳
+     * 註: 本套件之主鍵欄位固定為id，尚未支援由呼叫端指定
      * 註: 本函數不得有副作用，故不建立唯一索引
      *
      * @memberOf WOrmMongodb
-     * @param {String} id 輸入id字串
-     * @returns {Promise} 回傳Promise，resolve回傳數據物件，若無此id或id無效則回傳null，reject回傳錯誤訊息
+     * @param {String} pk 輸入主鍵值字串，即數據之id
+     * @returns {Promise} 回傳Promise，resolve回傳數據物件，若無此主鍵或主鍵值無效則回傳null，reject回傳錯誤訊息
      */
-    async function selectById(id) {
+    async function selectByPk(pk) {
         let isErr = false
 
         //check
-        if (!isestr(id)) {
-            //未給有效id視為查無數據, 判定基準與insert、save、del內對id之認定一致
+        if (!isestr(pk)) {
+            //未給有效主鍵值視為查無數據, 判定基準與insert、save、del內對id之認定一致
             return null
         }
 
@@ -349,7 +353,7 @@ function WOrmMongodb(opt = {}) {
             let collection = database.collection(opt.cl)
 
             //findOne, 以投影去除_id, 令回傳形狀與select一致
-            let v = await collection.findOne({ id }, { projection: { _id: 0 } })
+            let v = await collection.findOne({ id: pk }, { projection: { _id: 0 } })
 
             //check, 判定基準與insert、save、del內對既有數據之認定一致
             if (iseobj(v)) {
@@ -956,20 +960,21 @@ function WOrmMongodb(opt = {}) {
 
 
     /**
-     * 使用GridFS，由id查詢單筆數據
-     * 註: 查無數據或id無效時回傳null，判定基準與selectById一致
+     * 使用GridFS，由主鍵查詢單筆數據
+     * 註: 查無數據或主鍵值無效時回傳null，判定基準與selectByPk一致
+     * 註: 本套件之主鍵欄位固定為id，尚未支援由呼叫端指定
      * 本函數不得有副作用，故不建立唯一索引
      *
      * @memberOf WOrmMongodb
-     * @param {String} id 輸入查詢id字串
-     * @returns {Promise} 回傳Promise，resolve回傳數據物件{ id, u8a }，若無此id或id無效則回傳null，reject回傳錯誤訊息
+     * @param {String} pk 輸入主鍵值字串，即數據之id
+     * @returns {Promise} 回傳Promise，resolve回傳數據物件{ id, u8a }，若無此主鍵或主鍵值無效則回傳null，reject回傳錯誤訊息
      */
-    async function selectByIdGfs(id) {
+    async function selectByPkGfs(pk) {
         let isErr = false
 
         //check
-        if (!isestr(id)) {
-            //未給有效id視為查無數據, 判定基準與selectById一致
+        if (!isestr(pk)) {
+            //未給有效主鍵值視為查無數據, 判定基準與selectByPk一致
             return null
         }
 
@@ -1026,11 +1031,11 @@ function WOrmMongodb(opt = {}) {
         try {
 
             //core
-            let u8a = await core(id)
+            let u8a = await core(pk)
 
             //res, 形狀與insertGfs所收之數據物件一致
             res = {
-                id,
+                id: pk,
                 u8a,
             }
 
@@ -1287,12 +1292,12 @@ function WOrmMongodb(opt = {}) {
 
     //bind
     ee.select = select
-    ee.selectById = selectById
+    ee.selectByPk = selectByPk
     ee.insert = insert
     ee.save = save
     ee.del = del
     ee.delAll = delAll
-    ee.selectByIdGfs = selectByIdGfs
+    ee.selectByPkGfs = selectByPkGfs
     ee.insertGfs = insertGfs
     ee.delGfs = delGfs
     ee.delAllGfs = delAllGfs
@@ -1317,7 +1322,7 @@ export default WOrmMongodb
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sun Aug 16 2026 22:37:44 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 Sun Aug 16 2026 23:36:47 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/index.html

@@ -29,7 +29,7 @@
 <nav >
     
     
-    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="WOrmMongodb.html">WOrmMongodb</a><ul class='methods'><li data-type='method'><a href="WOrmMongodb.html#.del">del</a></li><li data-type='method'><a href="WOrmMongodb.html#.delAll">delAll</a></li><li data-type='method'><a href="WOrmMongodb.html#.delAllGfs">delAllGfs</a></li><li data-type='method'><a href="WOrmMongodb.html#.delGfs">delGfs</a></li><li data-type='method'><a href="WOrmMongodb.html#.insert">insert</a></li><li data-type='method'><a href="WOrmMongodb.html#.insertGfs">insertGfs</a></li><li data-type='method'><a href="WOrmMongodb.html#.save">save</a></li><li data-type='method'><a href="WOrmMongodb.html#.select">select</a></li><li data-type='method'><a href="WOrmMongodb.html#.selectById">selectById</a></li><li data-type='method'><a href="WOrmMongodb.html#.selectByIdGfs">selectByIdGfs</a></li></ul></li></ul>
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="WOrmMongodb.html">WOrmMongodb</a><ul class='methods'><li data-type='method'><a href="WOrmMongodb.html#.del">del</a></li><li data-type='method'><a href="WOrmMongodb.html#.delAll">delAll</a></li><li data-type='method'><a href="WOrmMongodb.html#.delAllGfs">delAllGfs</a></li><li data-type='method'><a href="WOrmMongodb.html#.delGfs">delGfs</a></li><li data-type='method'><a href="WOrmMongodb.html#.insert">insert</a></li><li data-type='method'><a href="WOrmMongodb.html#.insertGfs">insertGfs</a></li><li data-type='method'><a href="WOrmMongodb.html#.save">save</a></li><li data-type='method'><a href="WOrmMongodb.html#.select">select</a></li><li data-type='method'><a href="WOrmMongodb.html#.selectByPk">selectByPk</a></li><li data-type='method'><a href="WOrmMongodb.html#.selectByPkGfs">selectByPkGfs</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 Sun Aug 16 2026 22:37:44 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 Sun Aug 16 2026 23:36:47 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/g-basic.mjs

@@ -102,13 +102,13 @@ async function test() {
     let sr = await wo.select({ name: { $regex: 'PeT', $options: 'i' } })
     console.log('selectReg', sr)
 
-    //selectById, 由id直接查找單筆, 不需如select提取全部符合數據再處理
-    let sbi = await wo.selectById('id-rosemary')
-    console.log('selectById', sbi)
+    //selectByPk, 由id直接查找單筆, 不需如select提取全部符合數據再處理
+    let sbi = await wo.selectByPk('id-rosemary')
+    console.log('selectByPk', sbi)
 
-    //selectById by id not existed
-    let sbn = await wo.selectById('id-not-existed')
-    console.log('selectById by id not existed', sbn)
+    //selectByPk by id not existed
+    let sbn = await wo.selectByPk('id-not-existed')
+    console.log('selectByPk by id not existed', sbn)
 
     //del
     let d = ss.filter(function(v) {
@@ -165,8 +165,8 @@ test()
 //   }
 // ]
 // selectReg [ { id: 'id-peter', name: 'peter(modify)', value: 123 } ]
-// selectById { id: 'id-rosemary', name: 'rosemary(modify)', value: 123.456 }
-// selectById by id not existed null
+// selectByPk { id: 'id-rosemary', name: 'rosemary(modify)', value: 123.456 }
+// selectByPk by id not existed null
 // change del
 // del then [ { n: 1, nDeleted: 1, ok: 1 } ]
 

package/g-gfs.mjs

@@ -49,15 +49,15 @@ async function test() {
     let gr = await wo.insertGfs({ id: 'id-file', u8a: genU8a(50) })
     console.log('insertGfs existed id', gr)
 
-    //selectByIdGfs
-    let gs = await wo.selectByIdGfs('id-file')
-    console.log('selectByIdGfs id', gs.id)
-    console.log('selectByIdGfs u8a.length', gs.u8a.length)
-    console.log('selectByIdGfs u8a[0..3]', gs.u8a[0], gs.u8a[1], gs.u8a[2], gs.u8a[3])
+    //selectByPkGfs
+    let gs = await wo.selectByPkGfs('id-file')
+    console.log('selectByPkGfs id', gs.id)
+    console.log('selectByPkGfs u8a.length', gs.u8a.length)
+    console.log('selectByPkGfs u8a[0..3]', gs.u8a[0], gs.u8a[1], gs.u8a[2], gs.u8a[3])
 
-    //selectByIdGfs by id not existed
-    let gn = await wo.selectByIdGfs('id-not-existed')
-    console.log('selectByIdGfs by id not existed', gn)
+    //selectByPkGfs by id not existed
+    let gn = await wo.selectByPkGfs('id-not-existed')
+    console.log('selectByPkGfs by id not existed', gn)
 
     //insertGfs, 一次插入多筆
     let gm = await wo.insertGfs([
@@ -86,10 +86,10 @@ test()
 // insertGfs { n: 1, nInserted: 1, ok: 1 }
 // change insertGfs
 // insertGfs existed id { n: 1, nInserted: 0, ok: 1 }
-// selectByIdGfs id id-file
-// selectByIdGfs u8a.length 1000
-// selectByIdGfs u8a[0..3] 0 1 2 3
-// selectByIdGfs by id not existed null
+// selectByPkGfs id id-file
+// selectByPkGfs u8a.length 1000
+// selectByPkGfs u8a[0..3] 0 1 2 3
+// selectByPkGfs by id not existed null
 // change insertGfs
 // insertGfs multi { n: 2, nInserted: 2, ok: 1 }
 // change delGfs

package/g-unique.mjs

@@ -28,12 +28,12 @@ async function test() {
         { id: 'id-uniq', name: 'uniq' },
     ])
     console.log('insert with duplicated id', ri)
-    console.log('selectById(id-dup)', await wo.selectById('id-dup'))
+    console.log('selectByPk(id-dup)', await wo.selectByPk('id-dup'))
 
     //insert, 對已存在id再插入則跳過而不覆寫
     let re = await wo.insert({ id: 'id-dup', name: 'dup-3' })
     console.log('insert existed id', re)
-    console.log('selectById(id-dup)', await wo.selectById('id-dup'))
+    console.log('selectByPk(id-dup)', await wo.selectByPk('id-dup'))
 
     //insert, 併發對同一id插入10次, nInserted總和為1
     let rc = await Promise.all(Array.from({ length: 10 }, (v, k) => {
@@ -48,19 +48,19 @@ async function test() {
     }))
     console.log('count of nInserted===1 by 5 concurrent save', rs.filter((v) => v[0].nInserted === 1).length)
     console.log('records of id-new', (await wo.select({ id: 'id-new' })).length)
-    console.log('selectById(id-new)', await wo.selectById('id-new'))
+    console.log('selectByPk(id-new)', await wo.selectByPk('id-new'))
 
 }
 test()
 // insert with duplicated id { n: 3, nInserted: 2, ok: 1 }
-// selectById(id-dup) { id: 'id-dup', name: 'dup-1' }
+// selectByPk(id-dup) { id: 'id-dup', name: 'dup-1' }
 // insert existed id { n: 1, nInserted: 0, ok: 1 }
-// selectById(id-dup) { id: 'id-dup', name: 'dup-1' }
+// selectByPk(id-dup) { id: 'id-dup', name: 'dup-1' }
 // sum of nInserted by 10 concurrent insert 1
 // records of id-race 1
 // count of nInserted===1 by 5 concurrent save 1
 // records of id-new 1
-// selectById(id-new) { id: 'id-new', f0: 0, f1: 1, f2: 2, f4: 4, f3: 3 }
+// selectByPk(id-new) { id: 'id-new', f0: 0, f1: 1, f2: 2, f4: 4, f3: 3 }
 // 註: 併發儲存之各欄位皆會保留, 惟欄位順序取決於各次儲存之完成順序, 故每次執行不盡相同
 
 //node g-unique.mjs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "w-orm-mongodb",
-  "version": "1.1.38",
+  "version": "1.1.39",
   "main": "dist/w-orm-mongodb.umd.js",
   "dependencies": {
     "mongodb": "^7.5.0",

package/src/WOrmMongodb.mjs

@@ -20,6 +20,9 @@ import pmSeries from 'wsemi/src/pmSeries.mjs'
 /**
  * 操作資料庫(MongoDB)
  *
+ * 本套件之主鍵欄位固定為id，尚未支援由呼叫端指定。
+ * id為無業務語義之識別碼，故insert與save於輸入未帶有效id時自動補值；del不補值。
+ *
  * @class
  * @param {Object} [opt={}] 輸入設定物件，預設{}
  * @param {String} [opt.url='mongodb://127.0.0.1:27017'] 輸入連接資料庫字串，預設'mongodb://127.0.0.1:27017'
@@ -274,19 +277,20 @@ function WOrmMongodb(opt = {}) {
 
 
     /**
-     * 由id查詢單筆數據，因由MongoDB查找且僅回傳單筆，不需如select提取全部符合數據再處理，故數據量大時效能較佳
+     * 由主鍵查詢單筆數據，因由MongoDB查找且僅回傳單筆，不需如select提取全部符合數據再處理，故數據量大時效能較佳
+     * 註: 本套件之主鍵欄位固定為id，尚未支援由呼叫端指定
      * 註: 本函數不得有副作用，故不建立唯一索引
      *
      * @memberOf WOrmMongodb
-     * @param {String} id 輸入id字串
-     * @returns {Promise} 回傳Promise，resolve回傳數據物件，若無此id或id無效則回傳null，reject回傳錯誤訊息
+     * @param {String} pk 輸入主鍵值字串，即數據之id
+     * @returns {Promise} 回傳Promise，resolve回傳數據物件，若無此主鍵或主鍵值無效則回傳null，reject回傳錯誤訊息
      */
-    async function selectById(id) {
+    async function selectByPk(pk) {
         let isErr = false
 
         //check
-        if (!isestr(id)) {
-            //未給有效id視為查無數據, 判定基準與insert、save、del內對id之認定一致
+        if (!isestr(pk)) {
+            //未給有效主鍵值視為查無數據, 判定基準與insert、save、del內對id之認定一致
             return null
         }
 
@@ -302,7 +306,7 @@ function WOrmMongodb(opt = {}) {
             let collection = database.collection(opt.cl)
 
             //findOne, 以投影去除_id, 令回傳形狀與select一致
-            let v = await collection.findOne({ id }, { projection: { _id: 0 } })
+            let v = await collection.findOne({ id: pk }, { projection: { _id: 0 } })
 
             //check, 判定基準與insert、save、del內對既有數據之認定一致
             if (iseobj(v)) {
@@ -909,20 +913,21 @@ function WOrmMongodb(opt = {}) {
 
 
     /**
-     * 使用GridFS，由id查詢單筆數據
-     * 註: 查無數據或id無效時回傳null，判定基準與selectById一致
+     * 使用GridFS，由主鍵查詢單筆數據
+     * 註: 查無數據或主鍵值無效時回傳null，判定基準與selectByPk一致
+     * 註: 本套件之主鍵欄位固定為id，尚未支援由呼叫端指定
      * 本函數不得有副作用，故不建立唯一索引
      *
      * @memberOf WOrmMongodb
-     * @param {String} id 輸入查詢id字串
-     * @returns {Promise} 回傳Promise，resolve回傳數據物件{ id, u8a }，若無此id或id無效則回傳null，reject回傳錯誤訊息
+     * @param {String} pk 輸入主鍵值字串，即數據之id
+     * @returns {Promise} 回傳Promise，resolve回傳數據物件{ id, u8a }，若無此主鍵或主鍵值無效則回傳null，reject回傳錯誤訊息
      */
-    async function selectByIdGfs(id) {
+    async function selectByPkGfs(pk) {
         let isErr = false
 
         //check
-        if (!isestr(id)) {
-            //未給有效id視為查無數據, 判定基準與selectById一致
+        if (!isestr(pk)) {
+            //未給有效主鍵值視為查無數據, 判定基準與selectByPk一致
             return null
         }
 
@@ -979,11 +984,11 @@ function WOrmMongodb(opt = {}) {
         try {
 
             //core
-            let u8a = await core(id)
+            let u8a = await core(pk)
 
             //res, 形狀與insertGfs所收之數據物件一致
             res = {
-                id,
+                id: pk,
                 u8a,
             }
 
@@ -1240,12 +1245,12 @@ function WOrmMongodb(opt = {}) {
 
     //bind
     ee.select = select
-    ee.selectById = selectById
+    ee.selectByPk = selectByPk
     ee.insert = insert
     ee.save = save
     ee.del = del
     ee.delAll = delAll
-    ee.selectByIdGfs = selectByIdGfs
+    ee.selectByPkGfs = selectByPkGfs
     ee.insertGfs = insertGfs
     ee.delGfs = delGfs
     ee.delAllGfs = delAllGfs

package/test/api-basic.test.mjs

@@ -296,10 +296,10 @@ describe('basic', function() {
         // vans[17] = []
         vget[17] = await wo.select({ name: 'not-existed' })
 
-        //selectById, 由id直接查找單筆
+        //selectByPk, 由id直接查找單筆
         rt = null
         // vans[10] = { id: 'id-rosemary', name: 'rosemary(modify)', value: 123.456 }
-        await wo.selectById('id-rosemary')
+        await wo.selectByPk('id-rosemary')
             .then(function(msg) {
                 rt = msg
             })
@@ -308,16 +308,16 @@ describe('basic', function() {
             })
         vget[10] = rt
 
-        //selectById, 與select(find)取得同一筆之內容須一致
+        //selectByPk, 與select(find)取得同一筆之內容須一致
         // vans[11] = true
-        let sbi = await wo.selectById('id-peter')
+        let sbi = await wo.selectByPk('id-peter')
         let sbf = await wo.select({ id: 'id-peter' })
         vget[11] = JSON.stringify(sbi) === JSON.stringify(sbf[0])
 
-        //selectById by id not existed
+        //selectByPk by id not existed
         rt = null
         // vans[12] = null
-        await wo.selectById('id-not-existed')
+        await wo.selectByPk('id-not-existed')
             .then(function(msg) {
                 rt = msg
             })
@@ -326,12 +326,12 @@ describe('basic', function() {
             })
         vget[12] = rt
 
-        //selectById by id invalid, 未給有效id視為查無數據
+        //selectByPk by id invalid, 未給有效id視為查無數據
         // vans[13] = [null, null, null]
         vget[13] = [
-            await wo.selectById(''),
-            await wo.selectById(123),
-            await wo.selectById(null),
+            await wo.selectByPk(''),
+            await wo.selectByPk(123),
+            await wo.selectByPk(null),
         ]
 
         //del
@@ -349,9 +349,9 @@ describe('basic', function() {
             })
         vget[14] = rt
 
-        //selectById, 已刪除者須回傳null
+        //selectByPk, 已刪除者須回傳null
         // vans[15] = null
-        vget[15] = await wo.selectById(d[0].id)
+        vget[15] = await wo.selectByPk(d[0].id)
 
     })
 
@@ -422,22 +422,22 @@ describe('basic', function() {
     })
 
     vans[10] = { id: 'id-rosemary', name: 'rosemary(modify)', value: 123.456 }
-    it(`should get ${JSON.stringify(vans[10])} for selectById`, async function() {
+    it(`should get ${JSON.stringify(vans[10])} for selectByPk`, async function() {
         assert.strict.deepStrictEqual(vget[10], vans[10])
     })
 
     vans[11] = true
-    it(`should get ${JSON.stringify(vans[11])} for same content between selectById and select`, async function() {
+    it(`should get ${JSON.stringify(vans[11])} for same content between selectByPk and select`, async function() {
         assert.strict.deepStrictEqual(vget[11], vans[11])
     })
 
     vans[12] = null
-    it(`should get ${JSON.stringify(vans[12])} for selectById by id not existed`, async function() {
+    it(`should get ${JSON.stringify(vans[12])} for selectByPk by id not existed`, async function() {
         assert.strict.deepStrictEqual(vget[12], vans[12])
     })
 
     vans[13] = [null, null, null]
-    it(`should get ${JSON.stringify(vans[13])} for selectById by id invalid`, async function() {
+    it(`should get ${JSON.stringify(vans[13])} for selectByPk by id invalid`, async function() {
         assert.strict.deepStrictEqual(vget[13], vans[13])
     })
 
@@ -447,7 +447,7 @@ describe('basic', function() {
     })
 
     vans[15] = null
-    it(`should get ${JSON.stringify(vans[15])} for selectById after del`, async function() {
+    it(`should get ${JSON.stringify(vans[15])} for selectByPk after del`, async function() {
         assert.strict.deepStrictEqual(vget[15], vans[15])
     })
 
@@ -510,10 +510,10 @@ describe('insert', function() {
         vget[7] = (await wo.select()).length
 
         //同批重複者僅首筆入庫
-        vget[8] = (await wo.selectById('i-dup')).name
+        vget[8] = (await wo.selectByPk('i-dup')).name
 
         //已存在id不得被insert覆寫
-        vget[9] = await wo.selectById('i2')
+        vget[9] = await wo.selectByPk('i2')
 
         //併發後僅存單筆
         vget[10] = (await wo.select({ id: 'i-race' })).length
@@ -605,7 +605,7 @@ describe('save', function() {
         await Promise.all(Array.from({ length: 10 }, (v, k) => {
             return wo.save({ id: 'u1', [`f${k}`]: k })
         }))
-        let vu1 = await wo.selectById('u1')
+        let vu1 = await wo.selectByPk('u1')
         vget[1] = Object.keys(vu1).filter((k) => k.indexOf('f') === 0).length
         vget[2] = vu1.base
 
@@ -616,7 +616,7 @@ describe('save', function() {
         vget[3] = rsn.filter((v) => v[0].nInserted === 1).length
         vget[4] = rsn.filter((v) => v[0].ok !== 1).length
         vget[5] = (await wo.select({ id: 'w1' })).length
-        vget[6] = Object.keys(await wo.selectById('w1')).filter((k) => k.indexOf('g') === 0).length
+        vget[6] = Object.keys(await wo.selectByPk('w1')).filter((k) => k.indexOf('g') === 0).length
 
         //save內容相同不更新, 由MongoDB於伺服器端比對合併後結果與現值
         await wo.insert({ id: 's1', name: 'same', value: 5 })
@@ -633,11 +633,11 @@ describe('save', function() {
         //save內容不同須更新, 未給之欄位須保留
         await wo.insert({ id: 'd1', name: 'diff', value: 5 })
         vget[8] = await wo.save({ id: 'd1', value: 6 })
-        vget[9] = await wo.selectById('d1')
+        vget[9] = await wo.selectByPk('d1')
 
         //save(autoInsert=false)對不存在之id不得插入
         vget[10] = await wo.save({ id: 'n1', name: 'none' }, { autoInsert: false })
-        vget[11] = await wo.selectById('n1')
+        vget[11] = await wo.selectByPk('n1')
 
         //併發save(autoInsert=false)對既有id之不同欄位, 各欄位皆須保留且不得報錯
         await wo.insert({ id: 'p1', name: 'origin', value: 1 })
@@ -646,7 +646,7 @@ describe('save', function() {
             wo.save({ id: 'p1', value: 88 }, { autoInsert: false }),
         ])
         vget[12] = rsu.filter((v) => v[0].ok !== 1).length
-        vget[13] = await wo.selectById('p1')
+        vget[13] = await wo.selectByPk('p1')
 
         //change事件, autoInsert時仍須發出insert事件
         let woEv = WOrm(genOpt('saveevent'))
@@ -812,10 +812,10 @@ describe('save single failure', function() {
         }
 
         //單筆失敗不得中斷整批, 後續筆仍須寫入
-        vget[7] = (await wo.selectById('f3')).name
+        vget[7] = (await wo.selectByPk('f3')).name
 
         //失敗筆不得被寫入
-        vget[8] = await wo.selectById('f2')
+        vget[8] = await wo.selectByPk('f2')
 
     })
 
@@ -920,7 +920,7 @@ describe('del', function() {
         vget[15] = typeof rbig[0].err === 'string' && rbig[0].err.length > 0
 
         //單筆失敗不得中斷整批, 後續筆仍須刪除
-        vget[16] = await wo.selectById('k3')
+        vget[16] = await wo.selectByPk('k3')
 
     })
 
@@ -1094,7 +1094,7 @@ describe('change event', function() {
         })
 
         vget[1] = await wo.insert({ id: 'e1', name: 'a' })
-        vget[2] = await wo.selectById('e1')
+        vget[2] = await wo.selectByPk('e1')
         vget[3] = await wo.save({ id: 'e1', name: 'b' })
         vget[4] = await wo.del({ id: 'e1' })
         vget[5] = await wo.delAll()
@@ -1160,7 +1160,7 @@ describe('cross process concurrency', function() {
             runProc('P1', clSav, 'save', keys),
             runProc('P2', clSav, 'save', keys),
         ])
-        let vx1 = await woSav.selectById('x1')
+        let vx1 = await woSav.selectByPk('x1')
         vget[4] = Object.keys(vx1).filter((k) => k.indexOf('P1k') === 0 || k.indexOf('P2k') === 0).length
         vget[5] = vx1.base
         vget[6] = (await woSav.select()).length

package/test/api-gfs.test.mjs

@@ -139,10 +139,10 @@ describe('gfs basic', function() {
         // vans[3] = { files: 1, chunks: 2 }
         vget[3] = await countDocs(cl)
 
-        //selectByIdGfs, 取回內容須與來源逐位元組相同, 且形狀與insertGfs所收之數據物件一致
+        //selectByPkGfs, 取回內容須與來源逐位元組相同, 且形狀與insertGfs所收之數據物件一致
         rt = null
         // vans[4] = { keys: 'id,u8a', id: 'g-big', length: nSize, hash, b0: 0, b1: 1, b255: 255, b256: 0 }
-        await wo.selectByIdGfs('g-big')
+        await wo.selectByPkGfs('g-big')
             .then(function(msg) {
                 rt = {
                     keys: genKeys(msg),
@@ -160,10 +160,10 @@ describe('gfs basic', function() {
             })
         vget[4] = rt
 
-        //selectByIdGfs by id not existed
+        //selectByPkGfs by id not existed
         rt = null
         // vans[5] = null
-        await wo.selectByIdGfs('id-not-existed')
+        await wo.selectByPkGfs('id-not-existed')
             .then(function(msg) {
                 rt = msg
             })
@@ -172,12 +172,12 @@ describe('gfs basic', function() {
             })
         vget[5] = rt
 
-        //selectByIdGfs by id invalid, 未給有效id視為查無數據
+        //selectByPkGfs by id invalid, 未給有效id視為查無數據
         // vans[6] = [null, null, null]
         vget[6] = [
-            await wo.selectByIdGfs(''),
-            await wo.selectByIdGfs(123),
-            await wo.selectByIdGfs(null),
+            await wo.selectByPkGfs(''),
+            await wo.selectByPkGfs(123),
+            await wo.selectByPkGfs(null),
         ]
 
         //insertGfs未給id時自動產生
@@ -284,17 +284,17 @@ describe('gfs basic', function() {
         b255: 255,
         b256: 0,
     }
-    it(`should get same content for selectByIdGfs`, async function() {
+    it(`should get same content for selectByPkGfs`, async function() {
         assert.strict.deepStrictEqual(vget[4], vans[4])
     })
 
     vans[5] = null
-    it(`should get ${JSON.stringify(vans[5])} for selectByIdGfs by id not existed`, async function() {
+    it(`should get ${JSON.stringify(vans[5])} for selectByPkGfs by id not existed`, async function() {
         assert.strict.deepStrictEqual(vget[5], vans[5])
     })
 
     vans[6] = [null, null, null]
-    it(`should get ${JSON.stringify(vans[6])} for selectByIdGfs by id invalid`, async function() {
+    it(`should get ${JSON.stringify(vans[6])} for selectByPkGfs by id invalid`, async function() {
         assert.strict.deepStrictEqual(vget[6], vans[6])
     })
 
@@ -395,7 +395,7 @@ describe('gfs insert', function() {
         vget[3] = { files: c2.files - c1.files, chunks: c2.chunks - c1.chunks }
 
         //已存在id不得被覆寫, 內容須為首次所給
-        let vi1 = await wo.selectByIdGfs('i1')
+        let vi1 = await wo.selectByPkGfs('i1')
         vget[4] = genHash(vi1.u8a) === genHash(genU8a(100, 1))
 
         //部份重複, 1筆已存在2筆為新
@@ -411,7 +411,7 @@ describe('gfs insert', function() {
             { id: 'i-dup', u8a: genU8a(100, 7) },
             { id: 'i-uniq', u8a: genU8a(100, 8) },
         ])
-        let vdup = await wo.selectByIdGfs('i-dup')
+        let vdup = await wo.selectByPkGfs('i-dup')
         vget[7] = genHash(vdup.u8a) === genHash(genU8a(100, 6))
 
         //併發對同一id插入10次, nInserted總和須為1
@@ -545,7 +545,7 @@ describe('gfs change event', function() {
         })
 
         vget[1] = await wo.insertGfs({ id: 'e1', u8a: genU8a(100, 1) })
-        vget[2] = genHash((await wo.selectByIdGfs('e1')).u8a) === genHash(genU8a(100, 1))
+        vget[2] = genHash((await wo.selectByPkGfs('e1')).u8a) === genHash(genU8a(100, 1))
         vget[3] = await wo.delGfs({ id: 'e1' })
         vget[4] = await wo.delAllGfs()