wsemi 1.8.11 → 1.8.13

package/g.mjs

@@ -6,47 +6,165 @@ import fsCreateFolder from './src/fsCreateFolder.mjs'
 import fsDeleteFolder from './src/fsDeleteFolder.mjs'
 import fsSrlog from './src/fsSrlog.mjs'
 import dig from './src/dig.mjs'
-import fsDownloadFile from './src/fsDownloadFile.mjs'
+import genPm from './src/genPm.mjs'
+import delay from './src/delay.mjs'
+import cacheBd from './src/cacheBd.mjs'
 
-let test = async () => {
+
+let test1 = async () => {
     let ms = []
 
-    let fdt = './_test_fsDownloadFile'
-    fsCreateFolder(fdt) //創建任務資料夾
+    let fun = async(p1, p2) => {
+        await delay(300)
+        return `${p1}:${p2}`
+    }
+
+    let bc = cacheBd(fun)
+    let execFun = bc.get
+    let execFunCache = bc.getByCache
 
-    let urlIn = `https://raw.githubusercontent.com/yuda-lyu/w-demores/refs/heads/master/res/img/avatar/100.svg`
-    let fpOut = `${fdt}/100.svg`
-    await fsDownloadFile(urlIn, fpOut)
+    let pm1 = execFunCache(123, 'abc') //pm1執行取得快取, 因無快取將持續等待
+    pm1
         .then((res) => {
-            console.log('res', res)
-            ms.push({ fp: res })
+            // console.log('res', res)
+            ms.push({ result: `pm1-${res}` })
         })
-        .catch((err) => {
-            console.log('err', err)
+
+    let pm2 = execFun(4.56, 'def') //pm2執行原本函數與使用輸入, 會最先回傳, 且更新快取給等待或之後取得快取使用
+    pm2
+        .then((res) => {
+            // console.log('res', res)
+            ms.push({ result: `pm2-${res}` })
         })
 
-    let c = fs.readFileSync(fpOut, 'utf8')
-    console.log('c', c)
-    ms.push({ content: c })
+    let pm3 = execFunCache(78.9, 'xyz') //pm3執行取得快取, 因已有快取將直接取得快取
+    pm3
+        .then((res) => {
+            // console.log('res', res)
+            ms.push({ result: `pm3-${res}` })
+        })
+
+    await Promise.all([pm1, pm2, pm3])
+    // console.log('rs', rs)
+
+    console.log('ms', ms)
+    return ms
+}
+await test1()
+// ms [
+//   { result: 'pm2-4.56:def' },
+//   { result: 'pm1-4.56:def' },
+//   { result: 'pm3-4.56:def' }
+// ]
+
+
+let test2 = async () => {
+    let ms = []
+
+    let fun = async(p1, p2) => {
+        await delay(300)
+        return `${p1}:${p2}`
+    }
+
+    let bc = cacheBd(fun)
+    let execFun = bc.get
+    let execFunCache = bc.getByCache
+
+    setTimeout(() => {
+        console.log('pm1 exec..')
+        let pm1 = execFunCache(123, 'abc') //pm1執行取得快取, 因無快取將持續等待
+        pm1
+            .then((res) => {
+                console.log('pm1 then', res)
+                ms.push({ result: `pm1-${res}` })
+            })
+    }, 1)
+
+    setTimeout(() => {
+        console.log('pm2 exec..')
+        let pm2 = execFun(4.56, 'def') //1000ms後, pm2執行原本函數與使用輸入, 會最先回傳, 且更新快取給等待或之後取得快取使用
+        pm2
+            .then((res) => {
+                console.log('pm2 then', res)
+                ms.push({ result: `pm2-${res}` })
+            })
+    }, 1000)
+
+    setTimeout(() => {
+        console.log('pm3 exec..')
+        let pm3 = execFunCache(78.9, 'xyz') //pm3執行取得快取, 因已有快取將直接取得快取
+        pm3
+            .then((res) => {
+                console.log('pm3 then', res)
+                ms.push({ result: `pm3-${res}` })
+            })
+    }, 3000)
+
+    await delay(5000)
+
+    console.log('ms', ms)
+    return ms
+}
+await test2()
+// ms [
+//   { result: 'pm2-4.56:def' },
+//   { result: 'pm1-4.56:def' },
+//   { result: 'pm3-4.56:def' }
+// ]
+
+
+let test3 = async () => {
+    let ms = []
+
+    let fun = async(p1, p2) => {
+        await delay(300)
+        return `${p1}:${p2}`
+    }
+
+    let bc = cacheBd(fun)
+    let execFun = bc.get
+    let execFunCache = bc.getByCache
+
+    setTimeout(() => {
+        console.log('pm1 exec..')
+        let pm1 = execFunCache(123, 'abc') //pm1執行取得快取, 因無快取將持續等待, 3000ms將執行get與自己的輸入, 並最先回傳
+        pm1
+            .then((res) => {
+                console.log('pm1 then', res)
+                ms.push({ result: `pm1-${res}` })
+            })
+    }, 1)
+
+    setTimeout(() => {
+        console.log('pm2 exec..')
+        let pm2 = execFun(4.56, 'def') //3500ms後, pm2執行原本函數與使用輸入, 計算完畢則會覆蓋快取, 此快取將再給等待或之後取得快取使用
+        pm2
+            .then((res) => {
+                console.log('pm2 then', res)
+                ms.push({ result: `pm2-${res}` })
+            })
+    }, 3500)
+
+    setTimeout(() => {
+        console.log('pm3 exec..')
+        let pm3 = execFunCache(78.9, 'xyz') //pm3執行取得快取, 因已有快取將直接取得快取
+        pm3
+            .then((res) => {
+                console.log('pm3 then', res)
+                ms.push({ result: `pm3-${res}` })
+            })
+    }, 4500)
 
-    // fsDeleteFolder(fdt) //最終階段清除任務資料夾
+    await delay(6500)
 
     console.log('ms', ms)
     return ms
 }
-await test()
-    .catch((err) => {
-        console.log(err)
-    })
+await test3()
 // ms [
-//   { fp: './_test_fsDownloadFile/100.svg' },
-//   {
-//     content: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 231 231"><path d="M33.83,33.83a115.5,115.5,0,1,1,0,163.34,115.49,115.49,0,0,1,0-163.34Z" style="fill:#bcf700;"/><path d="m115.5 51.75a63.75 63.75 0 0 0-10.5 126.63v14.09a115.5 115.5 0 0 0-53.729 19.027 115.5 115.5 0 0 0 128.46 0 115.5 115.5 0 0 0-53.729-19.029v-14.084a63.75 63.75 0 0 0 53.25-62.881 63.75 63.75 0 0 0-63.65-63.75 63.75 63.75 0 0 0-0.09961 0z" style="fill:#b96438;"/><path d="m141.75 195a114.79 114.79 0 0 1 38 16.5 115.53 115.53 0 0 1-128.46 0 114.79 114.79 0 0 1 38-16.5l15.71 15.75h21z" style="fill:#304267;"/><path d="m115.45 211.34-10.55 10.54a2.51 2.51 0 0 1-3.5599 0 2 2 0 0 1-0.26999-0.30994l-18.48-25.4 5.8901-5.8899a2.52 2.52 0 0 1 3.5199-0.0791l23.49 21.14z" style="fill:#aab0b1;"/><path d="m115.45 211.34
-// 10.55 10.54a2.51 2.51 0 0 0 3.5599 0 2 2 0 0 0 0.26999-0.30994l18.48-25.4-5.8901-5.8899a2.52 2.52 0 0 0-3.4699-0.089l-23.49 21.14z" style="fill:#aab0b1;"/><path d="m158.41 199.58-10.11-3.2401v29.93q5.1601-1.5299 10.11-3.51zm-75.82 26.66v-29.9l-10.1 3.2401v23.14c3.2901 1.3199 6.67 2.4999 10.1 3.5199z" style="fill:#aab0b1;"/><path d="m157.79 67.5a61.31 61.31 0 0 1-42.79 17.43h-55.7c18.16-37.74 68.27-46.85 98.49-17.43z" style="fill:#531148;"/><path d="m122.93 7.0078c-10.503-0.15729-21.09 1.6448-29.545 5.4316-17.141 7.8999-32.169 23.297-43.973 38.779-5.1703 6.8631-8.7779 13.46-8.1855 18.395 0.93114 12.312 10.372 26.483 11.068 36.9 15.663-72.081 105.99-70.452 124.91-7.0525l4e-3 0.0156c5.616-10.926 8.0682-20.188 8.352-27.653 0.43654-15.607-7.8088-21.149-21.735-28.249 1.7934-3.7704 1.7273-7.5023
-// 2.0625-10.154-0.79964-7.8568-3.6796-13.51-10.43-17.758-5.9434-3.7404-13.06-6.0867-18.463-7.2266-4.5319-0.87895-9.2901-1.3562-14.064-1.4277z" style="fill:#531148;"/><path d="m42.426 75.338c0.52158 18.689 10.557 74.338-18.115 101.25 12.38 10.603 28.352 19.061 46.025 24.594 11.032-4.6874 22.88-7.4147 34.817-8.5046l0.0633-14.477c-22.49-4.3813-40.766-18.898-48.862-39.967-8.096-21.07-4.7931-44.72 9.2478-62.393zm124.67 2.7207c7.8997 10.886 11.743 24.64 11.787 37.441-0.36632 30.178-22.389 57.576-53.12 62.708l0.0238 14.471c12.282 1.1216 24.518 3.9888 35.825 8.9128 15.488-5.1448 30.007-13.325 42.396-25.043-13.136-22.051-23.282-63.045-18.694-101.55z" style="fill:#531148;"/><path d="m143.61 46.383c-11.639 0.12482-20.998 1.8906-20.998 1.8906l-9 3.5059c0.63003-0.0191 1.2603-0.0289 1.8906-0.0293h0.0996c35.169 0.055 60.959 27.235 63.283 63.383 7.4e-4 31.157-22.742 57.213-53.106 63.079l-0.0216 14.498c11.567 1.0563 23.154 3.6067 33.887 8.0463 35.952-15.315 55.082-52.303 36.709-68.279-5.018-7.9035-10.44-15.409-9.5544-23.03 5.0545-50.452 0.39626-63.561-43.189-63.064zm-69.966 21.09c-15.286 3.244-17.096 3.73-31.734 6.6953 3.0304 13.081 3.0583 22.274 1.2085 30.012-3.8004 11.361-8.9712 19.787-12.286 28.764-6.8823 22.459-2.9157 31.982 12.093 46.165 8.6595 8.0693 19.861 16.209 30.939 20.647 2.669-1.0316 5.3729-1.9628 8.106-2.792 7.4979-2.275 15.388-3.6535 23.206-4.3673l0.0433-14.393c-23.933-4.5937-44.283-21.98-50.77-45.817-6.3319-23.265 0.51104-48.752 19.195-64.914z" style="fill:none;"/><path d="m172.7 90.75h-6.54c-0.14-0.1-0.26-0.22-0.4-0.3-4.48-2.76-22.75-2.11-33.71 1.2-1 0.3-1.91 0.61-2.75 0.94-1.8937 0.79244-3.8739 1.3597-5.9 1.69-5.5051 0.79002-10.403 0.79002-15.908 0-2.0261-0.33034-4.0063-0.89756-5.9-1.69-0.84-0.33-1.76-0.64-2.75-0.94-11-3.31-29.23-4-33.71-1.2-0.13832 0.08869-0.2688 0.18906-0.39 0.3h-6.55c-1.1046 0-2 0.89543-2 2v4.66c-0.0013 0.98185 0.49088 1.8986 1.31 2.44l1.9 1.27c0.59238 0.38889 0.93475
-// 1.0622 0.9 1.77-0.14175 5.4854 0.88072 10.939 3 16 3.58 8.38 16 10.9 24.93 10.9 2.6976 0.0771 5.3921-0.2361 8-0.93 4.35-1.43 8.24-7.36 10.45-12.42 1.7607-3.8506 2.7493-8.009 2.91-12.24 7.3e-4 -0.7138 0.38183-1.3731 1-1.73 3.2281-1.951 6.5798-1.951 9.8079 0 0.61817 0.3569 0.99927 1.0162 1 1.73 0.16067 4.231 1.1493 8.3894 2.91 12.24 2.21 5.06 6.1 11 10.45 12.42 2.6079 0.6939 5.3024 1.0071 8 0.93 8.92 0 21.35-2.52 24.93-10.9 2.1193-5.0614 3.1418-10.515 3-16-0.0348-0.70778 0.30762-1.3811 0.9-1.77l1.9-1.27c0.81913-0.54136 1.3113-1.4582 1.31-2.44v-4.6c0.0336-1.1048-0.83521-2.0274-1.94-2.06z" style="fill:#000;stroke-linecap:round;stroke-linejoin:round;stroke-width:2.5;stroke:none;"/><polygon points="121.61 160.74 109.39 160.74 115.5 171.31" style="fill:#666;"/><path d="m132.64 144.06a34.42 34.42
-// 0 0 1-34.24 0" style="fill:none;stroke-linecap:round;stroke-linejoin:round;stroke-width:5.9998px;stroke:#000;"/></svg>'
-//   }
+//   { result: 'pm1-123:abc' },
+//   { result: 'pm2-4.56:def' },
+//   { result: 'pm3-4.56:def' }
 // ]
 
 //node g.mjs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wsemi",
-  "version": "1.8.11",
+  "version": "1.8.13",
   "main": "dist/wsemi.umd.js",
   "dependencies": {
     "chokidar": "^4.0.3",

package/src/cache.mjs

@@ -10,7 +10,7 @@ import cint from './cint.mjs'
 
 
 /**
- * 非同步函數快取
+ * 非同步函數快取，通過指定key代表函數與其輸入進行執行並快取，快取可設定失效時間，超過失效時間則重新執行與再更新快取
  *
  * Unit Test: {@link https://github.com/yuda-lyu/wsemi/blob/master/test/cache.test.mjs Github}
  * @memberOf wsemi

package/src/cacheBd.mjs

@@ -0,0 +1,237 @@
+import get from 'lodash-es/get.js'
+import ispint from './ispint.mjs'
+import cint from './cint.mjs'
+import delay from './delay.mjs'
+
+
+/**
+ * 封裝非同步函數與再提供使用快取版
+ *
+ * Unit Test: {@link https://github.com/yuda-lyu/wsemi/blob/master/test/cacheBd.test.mjs Github}
+ * @memberOf wsemi
+ * @param {Function} fun 輸入非同步函數
+ * @param {Object} [opt={}] 輸入設定物件，預設{}
+ * @param {Integer} [nMax=200] 輸入使用快取版之總嘗試次數整數，超過則報錯，預設200
+ * @param {Integer} [nTrigger=3] 輸入嘗試指定次數整數，若嘗試指定次數之後皆無快取則須自動執行get用以取得快取，預設3
+ * @returns {Object} 回傳事件物件，可呼叫事件get、getByCache，get為封裝後封裝原本非同步函數，getByCache為提供取用快取版之非同步函數，若有快取則優先使用，若超過指定次數則自動執行get使能取得快取
+ * @example
+ *
+ * let test1 = async () => {
+ *     let ms = []
+ *
+ *     let fun = async(p1, p2) => {
+ *         await delay(300)
+ *         return `${p1}:${p2}`
+ *     }
+ *
+ *     let bc = cacheBd(fun)
+ *     let execFun = bc.get
+ *     let execFunCache = bc.getByCache
+ *
+ *     let pm1 = execFunCache(123, 'abc') //pm1執行取得快取, 因無快取將持續等待
+ *     pm1
+ *         .then((res) => {
+ *             // console.log('res', res)
+ *             ms.push({ result: `pm1-${res}` })
+ *         })
+ *
+ *     let pm2 = execFun(4.56, 'def') //pm2執行原本函數與使用輸入, 會最先回傳, 且更新快取給等待或之後取得快取使用
+ *     pm2
+ *         .then((res) => {
+ *             // console.log('res', res)
+ *             ms.push({ result: `pm2-${res}` })
+ *         })
+ *
+ *     let pm3 = execFunCache(78.9, 'xyz') //pm3執行取得快取, 因已有快取將直接取得快取
+ *     pm3
+ *         .then((res) => {
+ *             // console.log('res', res)
+ *             ms.push({ result: `pm3-${res}` })
+ *         })
+ *
+ *     await Promise.all([pm1, pm2, pm3])
+ *     // console.log('rs', rs)
+ *
+ *     console.log('ms', ms)
+ *     return ms
+ * }
+ * await test1()
+ * // ms [
+ * //   { result: 'pm2-4.56:def' },
+ * //   { result: 'pm1-4.56:def' },
+ * //   { result: 'pm3-4.56:def' }
+ * // ]
+ *
+ * let test2 = async () => {
+ *     let ms = []
+ *
+ *     let fun = async(p1, p2) => {
+ *         await delay(300)
+ *         return `${p1}:${p2}`
+ *     }
+ *
+ *     let bc = cacheBd(fun)
+ *     let execFun = bc.get
+ *     let execFunCache = bc.getByCache
+ *
+ *     setTimeout(() => {
+ *         console.log('pm1 exec..')
+ *         let pm1 = execFunCache(123, 'abc') //pm1執行取得快取, 因無快取將持續等待
+ *         pm1
+ *             .then((res) => {
+ *                 console.log('pm1 then', res)
+ *                 ms.push({ result: `pm1-${res}` })
+ *             })
+ *     }, 1)
+ *
+ *     setTimeout(() => {
+ *         console.log('pm2 exec..')
+ *         let pm2 = execFun(4.56, 'def') //1000ms後, pm2執行原本函數與使用輸入, 會最先回傳, 且更新快取給等待或之後取得快取使用
+ *         pm2
+ *             .then((res) => {
+ *                 console.log('pm2 then', res)
+ *                 ms.push({ result: `pm2-${res}` })
+ *             })
+ *     }, 1000)
+ *
+ *     setTimeout(() => {
+ *         console.log('pm3 exec..')
+ *         let pm3 = execFunCache(78.9, 'xyz') //pm3執行取得快取, 因已有快取將直接取得快取
+ *         pm3
+ *             .then((res) => {
+ *                 console.log('pm3 then', res)
+ *                 ms.push({ result: `pm3-${res}` })
+ *             })
+ *     }, 3000)
+ *
+ *     await delay(5000)
+ *
+ *     console.log('ms', ms)
+ *     return ms
+ * }
+ * await test2()
+ * // ms [
+ * //   { result: 'pm2-4.56:def' },
+ * //   { result: 'pm1-4.56:def' },
+ * //   { result: 'pm3-4.56:def' }
+ * // ]
+ *
+ * let test3 = async () => {
+ *     let ms = []
+ *
+ *     let fun = async(p1, p2) => {
+ *         await delay(300)
+ *         return `${p1}:${p2}`
+ *     }
+ *
+ *     let bc = cacheBd(fun)
+ *     let execFun = bc.get
+ *     let execFunCache = bc.getByCache
+ *
+ *     setTimeout(() => {
+ *         console.log('pm1 exec..')
+ *         let pm1 = execFunCache(123, 'abc') //pm1執行取得快取, 因無快取將持續等待, 3000ms將執行get與自己的輸入, 並最先回傳
+ *         pm1
+ *             .then((res) => {
+ *                 console.log('pm1 then', res)
+ *                 ms.push({ result: `pm1-${res}` })
+ *             })
+ *     }, 1)
+ *
+ *     setTimeout(() => {
+ *         console.log('pm2 exec..')
+ *         let pm2 = execFun(4.56, 'def') //3500ms後, pm2執行原本函數與使用輸入, 計算完畢則會覆蓋快取, 此快取將再給等待或之後取得快取使用
+ *         pm2
+ *             .then((res) => {
+ *                 console.log('pm2 then', res)
+ *                 ms.push({ result: `pm2-${res}` })
+ *             })
+ *     }, 3500)
+ *
+ *     setTimeout(() => {
+ *         console.log('pm3 exec..')
+ *         let pm3 = execFunCache(78.9, 'xyz') //pm3執行取得快取, 因已有快取將直接取得快取
+ *         pm3
+ *             .then((res) => {
+ *                 console.log('pm3 then', res)
+ *                 ms.push({ result: `pm3-${res}` })
+ *             })
+ *     }, 4500)
+ *
+ *     await delay(6500)
+ *
+ *     console.log('ms', ms)
+ *     return ms
+ * }
+ * await test3()
+ * // ms [
+ * //   { result: 'pm1-123:abc' },
+ * //   { result: 'pm2-4.56:def' },
+ * //   { result: 'pm3-4.56:def' }
+ * // ]
+ *
+ */
+function cacheBd(fun, opt = {}) {
+
+    //nMax
+    let nMax = get(opt, 'nMax')
+    if (!ispint(nMax)) {
+        nMax = 200
+    }
+    nMax = cint(nMax)
+
+    //nTrigger
+    let nTrigger = get(opt, 'nTrigger')
+    if (!ispint(nTrigger)) {
+        nTrigger = 3
+    }
+    nTrigger = cint(nTrigger)
+
+    //快取
+    let cc = null
+
+    //函數執行狀態
+    let lock = false
+
+    //_get, 封裝原本非同步函數
+    let _get = async(...inputs) => {
+        lock = true
+        cc = await fun(...inputs) //若發生錯誤則向外報錯
+        lock = false
+        return cc
+    }
+
+    //_getByCache, 提供取用快取版之非同步函數, 若有快取則優先使用, 若超過指定次數則執行get使能取得快取
+    let _getByCache = async(...inputs) => {
+        for (let i = 1; i <= nMax; i++) {
+
+            //exec
+            if (i > nTrigger && !lock) {
+                // console.log('執行get使能取得快取...')
+                await _get(...inputs)
+                    .catch(() => {}) //取得快取時不向外報錯
+            }
+
+            //check
+            if (cc !== null) {
+                break
+            }
+
+            //delay
+            await delay(1000) //偵測週期1000ms
+
+        }
+        if (cc === null) {
+            throw new Error(`exceeded nMax[${nMax}]`)
+        }
+        return cc
+    }
+
+    return {
+        get: _get,
+        getByCache: _getByCache,
+    }
+}
+
+
+export default cacheBd

package/src/fsBuildReadStreamText.mjs

@@ -0,0 +1,109 @@
+import fs from 'fs'
+import readline from 'readline'
+import fsIsFile from './fsIsFile.mjs'
+import evem from './evem.mjs'
+
+
+/**
+ * 使用stream從檔案讀utf8文字
+ *
+ * Unit Test: {@link https://github.com/yuda-lyu/wsemi/blob/master/test/fsBuildReadStreamText.test.mjs Github}
+ * @memberOf wsemi
+ * @param {String} fp 輸入讀取檔案路徑字串
+ * @returns {EventEmitter} 回傳EventEmitter，可監聽create、line、close事件，line事件接收讀入各列字串
+ * @example
+ * need test in nodejs.
+ *
+ * let test = async () => {
+ *
+ *     let ms = []
+ *
+ *     let fdt = './_test_fsBuildReadStreamText'
+ *     fsCreateFolder(fdt) //創建臨時任務資料夾
+ *
+ *     let fn = 't1.txt'
+ *     let fp = `${fdt}/${fn}`
+ *
+ *     fs.writeFileSync(fp, `abc
+ * 測試中文
+ * def123xyz
+ * `, 'utf8')
+ *
+ *     let ev = fsBuildReadStreamText(fp)
+ *     ms.push({ 'create': '' })
+ *
+ *     ev.on('line', (line) => {
+ *         console.log('line', line)
+ *         ms.push({ line })
+ *     })
+ *
+ *     let pm = genPm()
+ *     ev.on('close', () => {
+ *         console.log('close')
+ *         pm.resolve()
+ *         ms.push({ 'close': '' })
+ *     })
+ *     await pm
+ *
+ *     fsDeleteFolder(fdt) //刪除臨時任務資料夾
+ *
+ *     console.log('ms', ms)
+ *     return ms
+ * }
+ * await test()
+ * // ms [
+ * //   { create: '' },
+ * //   { line: 'abc' },
+ * //   { line: '測試中文' },
+ * //   { line: 'def123xyz' },
+ * //   { close: '' }
+ * // ]
+ *
+ */
+function fsBuildReadStreamText(fp) {
+
+    //check
+    if (!fsIsFile(fp)) {
+        throw new Error(`fp is not a file`)
+    }
+
+    //ev
+    let ev = evem()
+
+    //stream
+    let stream = fs.createReadStream(fp, { encoding: 'utf8' })
+    ev.emit('create')
+
+    //rl
+    let rl = readline.createInterface({
+        input: stream,
+        crlfDelay: Infinity, //支援\r\n或\n
+    })
+
+    //rl line
+    rl.on('line', (line) => {
+        // console.log(`line`,line)
+        ev.emit('line', line)
+    })
+
+    // //rl close
+    // rl.on('close', () => {
+    //     // console.log('close')
+    // })
+
+    //stream close
+    stream.on('close', () => {
+        //stream close事件才代表檔案可刪除
+        ev.emit('close')
+    })
+
+    // //stream end
+    // stream.on('end', () => {
+    //     //stream end事件只是讀寫結束, 不代表檔案可刪除
+    // })
+
+    return ev
+}
+
+
+export default fsBuildReadStreamText

package/src/fsBuildWriteStreamText.mjs

@@ -3,12 +3,11 @@ import genPm from './genPm.mjs'
 
 
 /**
- * 使用stream寫入utf-8文字至檔案
+ * 使用stream寫入utf8文字至檔案
  *
  * Unit Test: {@link https://github.com/yuda-lyu/wsemi/blob/master/test/fsBuildWriteStreamText.test.mjs Github}
  * @memberOf wsemi
- * @param {String} fp 輸入檔案名稱
- * @param {String} c 輸入utf-8文字數據
+ * @returns {Object} 回傳函數物件，提供creat、write、end函數，create代表創建stream，可輸入fp為檔案路徑字串，write代表寫入字串，輸入c為字串(預設為行)，end代表結束stream，無輸入
  * @example
  * need test in nodejs.
  *
@@ -86,7 +85,13 @@ function fsBuildWriteStreamText() {
 
     //end
     let end = () => {
+        let pmm = genPm()
+        stream.on('close', () => {
+            //close事件才代表檔案可刪除
+            pmm.resolve()
+        })
         stream.end() //發出flush與close
+        return pmm
     }
 
     //r

package/src/index.mjs

@@ -55,6 +55,7 @@ export { default as bufReadDbl } from './bufReadDbl.mjs'
 export { default as bufWrite } from './bufWrite.mjs'
 export { default as bufWriteDbl } from './bufWriteDbl.mjs'
 export { default as cache } from './cache.mjs'
+export { default as cacheBd } from './cacheBd.mjs'
 export { default as cbol } from './cbol.mjs'
 export { default as cdbl } from './cdbl.mjs'
 export { default as ceil } from './ceil.mjs'
@@ -142,6 +143,7 @@ export { default as files2data } from './files2data.mjs'
 export { default as flattenToConn } from './flattenToConn.mjs'
 export { default as flattenTree } from './flattenTree.mjs'
 export { default as floor } from './floor.mjs'
+export { default as fsBuildReadStreamText } from './fsBuildReadStreamText.mjs'
 export { default as fsBuildWriteStreamText } from './fsBuildWriteStreamText.mjs'
 export { default as fsCleanFolder } from './fsCleanFolder.mjs'
 export { default as fsCleanFolderCore } from './fsCleanFolderCore.mjs'

package/src/pmDebounce.mjs

@@ -114,47 +114,6 @@ import cint from './cint.mjs'
  */
 function pmDebounce(ms = 300) {
 
-    // function ClsDebounceEasy(ms) { //簡易法, 因執行階段中無法儲存推入任務會被視為強制取消, 不合需求
-
-    //     //timer
-    //     let t = null
-
-    //     //pm
-    //     let pm = Promise.resolve()
-
-    //     //run
-    //     let run = (func, ...input) => {
-
-    //         //clearTimeout
-    //         clearTimeout(t)
-
-    //         // console.log('call fun')
-    //         return new Promise((resolve, reject) => {
-    //             // console.log('call in Promise', ...input, ms)
-
-    //             //setTimeout
-    //             t = setTimeout(async () => {
-    //                 // console.log('exec fun start', ...input, ms)
-
-    //                 try {
-    //                     let res = func(...input)
-    //                     if (ispm(res)) {
-    //                         res = await pm
-    //                     }
-    //                     resolve(res)
-    //                 }
-    //                 catch (err) {
-    //                     reject(err)
-    //                 }
-    //                 // console.log('exec fun end')
-
-    //             }, ms)
-    //         })
-    //     }
-
-    //     return run
-    // }
-
     function ClsDebounce(ms) {
         let q = [] //queue
         let t = null //timer
@@ -167,12 +126,6 @@ function pmDebounce(ms = 300) {
         }
         ms = cint(ms)
 
-        // //_tNow
-        // let _tNow = Date.now()
-        // let getIt = () => {
-        //     return Date.now() - _tNow
-        // }
-
         function detect() {
 
             //check