wsemi 1.9.13 → 1.9.15

package/docs/u8arr2bs.mjs.html

@@ -133,7 +133,7 @@ export default u8arr2bs
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 12 2026 12:18:17 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 Tue Oct 13 2026 23:59:17 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/u8arr2obj.mjs.html

@@ -200,7 +200,7 @@ export default u8arr2obj
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 12 2026 12:18:17 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 Tue Oct 13 2026 23:59:17 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/u8arr2str.mjs.html

@@ -132,7 +132,7 @@ export default u8arr2str
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 12 2026 12:18:17 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 Tue Oct 13 2026 23:59:17 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/u8arr2u16arr.mjs.html

@@ -130,7 +130,7 @@ export default u8arr2u16arr
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 12 2026 12:18:17 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 Tue Oct 13 2026 23:59:17 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/urlParse.mjs.html

@@ -111,7 +111,7 @@ export default urlParse
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 12 2026 12:18:17 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 Tue Oct 13 2026 23:59:17 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/verifyValue.mjs.html

@@ -224,7 +224,7 @@ export default verifyValue
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 12 2026 12:18:17 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 Tue Oct 13 2026 23:59:17 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/waitFun.mjs.html

@@ -215,7 +215,7 @@ export default waitFun
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 12 2026 12:18:17 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 Tue Oct 13 2026 23:59:17 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/wsemi.html

@@ -178,7 +178,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="execCliCore.mjs.html">execCliCore.mjs</a>, <a href="execCliCore.mjs.html#line265">line 265</a>
+        <a href="execCliCore.mjs.html">execCliCore.mjs</a>, <a href="execCliCore.mjs.html#line268">line 268</a>
     </li></ul></dd>
     
 
@@ -1689,7 +1689,7 @@ str與base64須與加密時str2aes所用之設定相同，否則解不出原文
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="alive.mjs.html">alive.mjs</a>, <a href="alive.mjs.html#line88">line 88</a>
+        <a href="alive.mjs.html">alive.mjs</a>, <a href="alive.mjs.html#line118">line 118</a>
     </li></ul></dd>
     
 
@@ -1736,7 +1736,7 @@ str與base64須與加密時str2aes所用之設定相同，否則解不出原文
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>async function topAsync() {
    function test1() {
        return new Promise((resolve, reject) => {
            let ms = []
            let oAL = alive({ timeAlive: 1500 })
            let t = Date.now()
            let a = { data: 123 }
            let b = { data: '34.56' }
            setTimeout(() => {
                console.log(parseInt((Date.now() - t)) + 'ms', 'trigger a1')
                oAL.trigger('a', a)
            }, 500)
            setTimeout(() => {
                console.log(parseInt((Date.now() - t)) + 'ms', 'trigger a2')
                oAL.trigger('a', a)
            }, 1900)
            setTimeout(() => {
                console.log(parseInt((Date.now() - t)) + 'ms', 'trigger b1')
                oAL.trigger('b', b)
            }, 1000)
            setTimeout(() => {
                console.log(parseInt((Date.now() - t)) + 'ms', 'trigger b2')
                oAL.trigger('b', b)
            }, 3000)
            oAL.on('message', function({ eventName, key, data, now }) {
                console.log(parseInt((Date.now() - t)) + 'ms', { eventName, key, data, now })
                ms.push(eventName + '|' + key)
            })
            setTimeout(() => {
                resolve(ms)
            }, 5000)
        })
    }
    console.log('test1')
    let r1 = await test1()
    console.log(JSON.stringify(r1))
    // test1
    // 503ms trigger a1
    // 508ms { eventName: 'enter', key: 'a', data: { data: 123 }, now: 1 }
    // 1001ms trigger b1
    // 1003ms { eventName: 'enter', key: 'b', data: { data: '34.56' }, now: 2 }
    // 1901ms trigger a2
    // 2523ms { eventName: 'leave', key: 'b', data: { data: '34.56' }, now: 1 }
    // 3002ms trigger b2
    // 3004ms { eventName: 'enter', key: 'b', data: { data: '34.56' }, now: 2 }
    // 3430ms { eventName: 'leave', key: 'a', data: { data: 123 }, now: 1 }
    // 4544ms { eventName: 'leave', key: 'b', data: { data: '34.56' }, now: 0 }
    // ["enter|a","enter|b","leave|b","enter|b","leave|a","leave|b"]
+    <pre class="prettyprint"><code>async function topAsync() {
    function test1() {
        return new Promise((resolve, reject) => {
            let ms = []
            let oAL = alive({ timeAlive: 1500 })
            let t = Date.now()
            let a = { data: 123 }
            let b = { data: '34.56' }
            setTimeout(() => {
                console.log(parseInt((Date.now() - t)) + 'ms', 'trigger a1')
                oAL.trigger('a', a)
            }, 500)
            setTimeout(() => {
                console.log(parseInt((Date.now() - t)) + 'ms', 'trigger a2')
                oAL.trigger('a', a)
            }, 1900)
            setTimeout(() => {
                console.log(parseInt((Date.now() - t)) + 'ms', 'trigger b1')
                oAL.trigger('b', b)
            }, 1000)
            setTimeout(() => {
                console.log(parseInt((Date.now() - t)) + 'ms', 'trigger b2')
                oAL.trigger('b', b)
            }, 3000)
            oAL.on('message', function({ eventName, key, data, now }) {
                console.log(parseInt((Date.now() - t)) + 'ms', { eventName, key, data, now })
                ms.push(eventName + '|' + key)
            })
            setTimeout(() => {
                resolve(ms)
            }, 5000)
        })
    }
    console.log('test1')
    let r1 = await test1()
    console.log(JSON.stringify(r1))
    // test1
    // 503ms trigger a1
    // 508ms { eventName: 'enter', key: 'a', data: { data: 123 }, now: 1 }
    // 1001ms trigger b1
    // 1003ms { eventName: 'enter', key: 'b', data: { data: '34.56' }, now: 2 }
    // 1901ms trigger a2
    // 2523ms { eventName: 'leave', key: 'b', data: { data: '34.56' }, now: 1 }
    // 3002ms trigger b2
    // 3004ms { eventName: 'enter', key: 'b', data: { data: '34.56' }, now: 2 }
    // 3430ms { eventName: 'leave', key: 'a', data: { data: 123 }, now: 1 }
    // 4544ms { eventName: 'leave', key: 'b', data: { data: '34.56' }, now: 0 }
    // ["enter|a","enter|b","leave|b","enter|b","leave|a","leave|b"]
    function test2() {
        return new Promise((resolve, reject) => {
            let ms = []
            let oAL = alive({ timeAlive: 1500 })
            oAL.on('message', function({ eventName, key }) {
                ms.push(eventName + '|' + key)
            })
            oAL.trigger('a', { data: 123 })
            setTimeout(() => {
                oAL.trigger('b', { data: '34.56' })
                let r = oAL.clear() //b剛trigger尚未發出enter, 故只回傳a, 且b之enter不再發出
                ms.push('clear|' + r.map((v) => v.key).join(','))
            }, 500)
            setTimeout(() => {
                resolve(ms)
            }, 2500)
        })
    }
    console.log('test2')
    let r2 = await test2()
    console.log(JSON.stringify(r2))
    // test2
    // ["enter|a","clear|a"]
 
 
 
@@ -1869,7 +1869,7 @@ str與base64須與加密時str2aes所用之設定相同，否則解不出原文
 
         
 <div class="param-desc">
-    <p>回傳事件物件，可呼叫函數on、trigger、get。trigger給予單元的唯一key字串與攜帶數據data物件，on為監聽事件，需自行監聽message事件取得單元進出事件。get事件可取得alive內視為存活的單元清單。事件物件為原生EventEmitter(eventemitter3)。本模組於派發處以try攔截監聽器之同步拋錯，故其不會使行程崩潰，會改以error事件回報{ fun: 'listener', name, msg, args }，無error監聽者則console.error；惟依EventEmitter規範，同一次派發中先拋錯之監聽器會中止該次派發，其後之監聽器不再被呼叫。async監聽器之reject不被攔截(規範上emit不觀察監聽器回傳值)，須由監聽器自行處理，否則為unhandledRejection</p>
+    <p>回傳事件物件，可呼叫函數on、trigger、get、clear。trigger給予單元的唯一key字串與攜帶數據data物件，on為監聽事件，需自行監聽message事件取得單元進出事件。get事件可取得alive內視為存活的單元清單(含剛trigger而尚未發出enter者)。clear為釋放：立即清除偵測計時器、取消尚未發出之enter、清空佇列，本身不發事件，其後不再發出任何事件、trigger無效、get回傳[]，可重複呼叫(釋放為終態，需重新偵測者另建alive)；clear回傳已發出enter且尚未leave之單元陣列[{ key, data }]，供使用端補發離線通知，再次呼叫回傳[]；監聽器於派發中呼叫clear亦安全，同一輪尚未處理之單元不再派發。事件物件為原生EventEmitter(eventemitter3)。本模組於派發處以try攔截監聽器之同步拋錯，故其不會使行程崩潰，會改以error事件回報{ fun: 'listener', name, msg, args }，無error監聽者則console.error；惟依EventEmitter規範，同一次派發中先拋錯之監聽器會中止該次派發，其後之監聽器不再被呼叫。async監聽器之reject不被攔截(規範上emit不觀察監聽器回傳值)，須由監聽器自行處理，否則為unhandledRejection</p>
 </div>
 
 
@@ -35253,7 +35253,7 @@ once自動移除等），封裝層自身反而成為「調用方拿到非預期
 <p>【為何不以setTimeout脫勾來迴避】</p>
 <p>setTimeout會開一個「沒有呼叫者」的堆疊，監聽器之同步拋錯於該處即為uncaughtException，
 且呼叫端無論如何try都攔不到（此與監聽器是否為async無關，純同步監聽器亦然）。
-於呼叫端之堆疊上派發，一個普通的try即可攔下。確實需要脫勾者請改用evEmitDefer，
+於呼叫端之堆疊上派發，一個普通的try即可攔下。確實需要脫勾者請改用evEmitDelay，
 其內部即以本函數派發，故仍有攔截。</p>
 <p>【為何不處理async監聽器之reject】</p>
 <p>emit依EventEmitter規範丟棄監聽器之回傳值，其rejection無人觀察；nodejs文件亦明載
@@ -36366,14 +36366,14 @@ ev.emit('evName', data)</code></pre>
     <dd class="tag-description"><ul class="dummy"><li><p>通用CLI子程序調用，封裝逾時、進程樹清理、輸出驗證、結構化錯誤回報與自動重試
 各參數原樣傳遞給目標CLI，支援中文
 Windows下npm全域安裝之命令為.cmd批次檔，Node.js spawn無法直接執行(CVE-2024-27980安全修正後回EINVAL)，內部已參考cross-spawn自動解析.cmd入口並繞過cmd.exe，故可支援含多行文字之參數
-本函數不throw，一律以結果物件之ok與error欄位回報成敗</p>
+本函數不throw，一律以結果物件之ok與error欄位回報成敗，error不含args與env之值(子程序自身之輸出另見stdout、stderr)</p>
 <p>Unit Test: <a href="https://github.com/yuda-lyu/wsemi/blob/master/test/execCli.test.mjs">Github</a></p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="execCli.mjs.html">execCli.mjs</a>, <a href="execCli.mjs.html#line373">line 373</a>
+        <a href="execCli.mjs.html">execCli.mjs</a>, <a href="execCli.mjs.html#line404">line 404</a>
     </li></ul></dd>
     
 
@@ -36857,7 +36857,7 @@ test()
                 </td>
             
 
-            <td class="description last"><p>輸入stdout串流回調函數，格式為(chunk)=&gt;{}，預設undefined</p></td>
+            <td class="description last"><p>輸入stdout串流回調函數，格式為(chunk)=&gt;{}，回調內拋出之錯誤不會被攔截，將成為未捕捉例外，請於回調內自行處理，預設undefined</p></td>
         </tr>
 
     
@@ -36895,7 +36895,7 @@ test()
                 </td>
             
 
-            <td class="description last"><p>輸入stderr串流回調函數，格式為(chunk)=&gt;{}，預設undefined</p></td>
+            <td class="description last"><p>輸入stderr串流回調函數，格式為(chunk)=&gt;{}，行為同onStdout，預設undefined</p></td>
         </tr>
 
     
@@ -36973,7 +36973,7 @@ test()
                 </td>
             
 
-            <td class="description last"><p>輸入失敗後最大重試次數非負整數，遇ENOENT(命令不存在)或exit code 2(參數錯誤)視為不可重試而立即中止，預設0</p></td>
+            <td class="description last"><p>輸入失敗後最大重試次數非負整數，遇ENOENT(命令不存在)、exit code 2(參數錯誤)或無法啟動子進程之同步錯誤(如參數過長、權限不足、非有效執行檔、參數含空字元)視為不可重試而立即中止，預設0</p></td>
         </tr>
 
     
@@ -37085,7 +37085,7 @@ test()
     <dt class="tag-description">Description:</dt>
     <dd class="tag-description"><ul class="dummy"><li><p>對stdio協定型CLI依序送出一行一則JSON之請求並收集回應(疊於execCliSession之上)，適用codex app-server、MCP之stdio伺服器等以換行分隔JSON之協定(LSP為Content-Length分幀，不適用)
 不內建任何協定知識，initialize/initialized等握手由呼叫端以請求陣列表達
-本函數不throw，一律以結果物件之ok與error、errorType欄位回報成敗</p>
+本函數不throw，一律以結果物件之ok與error、errorType欄位回報成敗，error不含args與env之值</p>
 <p>規則:</p>
 <ul>
 <li>請求物件含method者為請求，自動配id(自0遞增)並等待同id之回應；含notify者為通知，不配id，送出即繼續</li>
@@ -37746,7 +37746,7 @@ test()
                 </td>
             
 
-            <td class="description last"><p>輸入stderr片段回調函數，格式為(chunk)=&gt;{}，預設undefined</p></td>
+            <td class="description last"><p>輸入stderr片段回調函數，格式為(chunk)=&gt;{}，預設undefined。onNotify、onServerRequest、onStderr內拋出之錯誤不會被攔截，將成為未捕捉例外，請於回調內自行處理</p></td>
         </tr>
 
     
@@ -37818,14 +37818,14 @@ test()
     <dt class="tag-description">Description:</dt>
     <dd class="tag-description"><ul class="dummy"><li><p>建立互動式stdio工作階段(session)，用於stdio協定型之長駐CLI(如MCP之stdio伺服器、codex app-server等一行一則JSON之程式)，與execCli「寫完input即關閉stdin並等待結束」之一次性契約不同，本函數維持stdin開啟，由呼叫端逐次write，直到呼叫stop()才關閉stdin並等待子進程自行退出，逾寬限期則以execProcessKillPid樹殺
 Windows下npm全域安裝之命令為.cmd批次檔，內部經execCliCore.buildSpawnArgs解析為以node執行其JS入口，不使用shell:true，故樹殺可確實涵蓋子孫程序
-本函數不throw亦不reject，spawn失敗(如ENOENT)以onExit與stop()之結果物件回報</p>
+本函數不throw亦不reject，spawn失敗(如ENOENT)以onExit與stop()之結果物件回報，其error不含args與env之值</p>
 <p>Unit Test: <a href="https://github.com/yuda-lyu/wsemi/blob/master/test/execCliSession.test.mjs">Github</a></p></li></ul></dd>
     
 
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="execCliSession.mjs.html">execCliSession.mjs</a>, <a href="execCliSession.mjs.html#line79">line 79</a>
+        <a href="execCliSession.mjs.html">execCliSession.mjs</a>, <a href="execCliSession.mjs.html#line80">line 80</a>
     </li></ul></dd>
     
 
@@ -38463,7 +38463,7 @@ test()
                 </td>
             
 
-            <td class="description last"><p>輸入子進程結束回調函數，格式為(result)=&gt;{}，result同stop()之回傳，預設undefined</p></td>
+            <td class="description last"><p>輸入子進程結束回調函數，格式為(result)=&gt;{}，result同stop()之回傳，預設undefined。onLine、onStdout、onStderr、onExit內拋出之錯誤不會被攔截，將成為未捕捉例外，請於回調內自行處理</p></td>
         </tr>
 
     
@@ -38785,7 +38785,7 @@ if (true) {
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="execProcess.mjs.html">execProcess.mjs</a>, <a href="execProcess.mjs.html#line61">line 61</a>
+        <a href="execProcess.mjs.html">execProcess.mjs</a>, <a href="execProcess.mjs.html#line64">line 64</a>
     </li></ul></dd>
     
 
@@ -38847,6 +38847,7 @@ if (true) {
 
 if (true) {
     //execFile與spawn之args須為陣列, 每個元素為一個參數; 給字串會被當成單一參數而失敗
+    //密碼置於命令列參數時同機其他使用者可由程序列表看到; 失敗訊息不含args, 但子程序自身之輸出可能回顯
     let prog = `C:\\Program Files\\7-Zip\\7z.exe`
     let pw = 'AbcD1234'
     let args = ['a', 'abc.7z', 'abc.txt', `-p${pw}`]
@@ -38959,7 +38960,7 @@ if (true) {
                 </td>
             
 
-            <td class="description last"><p>輸入腳本檔案位置字串或參數</p></td>
+            <td class="description last"><p>輸入參數陣列或字串，例如腳本檔案位置字串，空陣列或空字串代表無參數；非陣列亦非字串時reject錯誤訊息(不拋錯)</p></td>
         </tr>
 
     
@@ -39062,7 +39063,7 @@ if (true) {
                 </td>
             
 
-            <td class="description last"><p>輸入執行模式字串，可選'spawn'、'exec'、'execFile'，預設'spawn'。'spawn'不經shell直接執行，輸出以串流處理，適合大量輸出或長時間執行，prog與args不需也不可加引號；'exec'經shell執行，prog與args以空白串接成指令字串，適合須用到shell語法之情形，陣列型args之元素含空白且未含雙引號者會自動以雙引號包住，prog含空白亦同，已含雙引號者視為呼叫端自行處理而原樣串接，字串型args視為呼叫端已自組之指令列，原樣串接不加引號；'execFile'不經shell直接執行可執行檔，args須為陣列，給字串會被當成單一參數。三種模式之stdout與stderr皆以Buffer接收後走同一條解碼路徑</p></td>
+            <td class="description last"><p>輸入執行模式字串，可選'spawn'、'exec'、'execFile'，預設'spawn'。'spawn'不經shell直接執行，輸出以串流處理，適合大量輸出或長時間執行，prog與args不需也不可加引號；'exec'經shell執行，prog與args以空白串接成指令字串，適合須用到shell語法之情形，陣列型args之元素含空白且未含雙引號者會自動以雙引號包住，prog含空白亦同，已含雙引號者視為呼叫端自行處理而原樣串接，字串型args視為呼叫端已自組之指令列，原樣串接不加引號；'execFile'不經shell直接執行可執行檔，args須為陣列，給字串會被當成單一參數。三種模式之stdout與stderr皆以Buffer接收後走同一條解碼路徑；惟'exec'與'execFile'之stdout或stderr超過1MB(node之maxBuffer預設值)時子程序會被node終止，reject為<code>code[null]:\n訊息</code>，大量輸出請用'spawn'</p></td>
         </tr>
 
     
@@ -39102,7 +39103,7 @@ if (true) {
                 </td>
             
 
-            <td class="description last"><p>輸入回調stdout函數，預設null。收到的是經串流解碼之字串，多位元組字元跨chunk時會等到完整才給，故不會收到空字串；codeCmd為'auto'時回調為盡力判定，該串流首次遇到非utf-8位元組後才改用系統字碼頁，之前已回調之字串不追溯，最終結果以resolve或reject之字串為準</p></td>
+            <td class="description last"><p>輸入回調stdout函數，預設null。收到的是經串流解碼之字串，多位元組字元跨chunk時會等到完整才給，故不會收到空字串；codeCmd為'auto'時回調為盡力判定，該串流首次遇到非utf-8位元組後才改用系統字碼頁，之前已回調之字串不追溯，最終結果以resolve或reject之字串為準。回調內拋出之錯誤不會被攔截，將成為未捕捉例外，請於回調內自行處理</p></td>
         </tr>
 
     
@@ -39295,7 +39296,7 @@ if (true) {
 
         
 <div class="param-desc">
-    <p>回傳Promise，resolve回傳stdout與stderr依到達順序合併之字串，不另加換行，子程序自己的換行原樣保留；reject回傳錯誤訊息，離開碼非0時為<code>code[N]:\n訊息</code>，逾時為<code>timeout[Nms]:\n訊息</code></p>
+    <p>回傳Promise，resolve回傳stdout與stderr依到達順序合併之字串，不另加換行，子程序自己的換行原樣保留；reject回傳錯誤訊息字串：離開碼非0時為<code>code[N]:\n訊息</code>，訊息為子程序之輸出，子程序因訊號結束時N為null；逾時為<code>timeout[Nms]:\n訊息</code>；無法啟動子程序時(找不到執行檔、權限不足、非有效執行檔、參數過長、參數含空字元、系統資源用盡等)為<code>spawn[錯誤碼]:\n訊息</code>，訊息為node之錯誤說明(可含執行檔路徑)，不含args之內容；args型別不符、codeCmd不支援或spawn模式prog含引號時為說明字串</p>
 </div>
 
 
@@ -39339,7 +39340,7 @@ if (true) {
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="execProcessKillPid.mjs.html">execProcessKillPid.mjs</a>, <a href="execProcessKillPid.mjs.html#line27">line 27</a>
+        <a href="execProcessKillPid.mjs.html">execProcessKillPid.mjs</a>, <a href="execProcessKillPid.mjs.html#line28">line 28</a>
     </li></ul></dd>
     
 
@@ -39473,7 +39474,7 @@ if (true) {
 
         
 <div class="param-desc">
-    <p>回傳Promise，resolve回傳成功訊息，reject回傳錯誤訊息</p>
+    <p>回傳Promise，resolve回傳成功訊息<code>pid[N] killed</code>，reject回傳錯誤訊息字串<code>pid[N] kill failed: 訊息</code>；Windows下訊息含taskkill之輸出，其為系統字碼頁而可能無法正確顯示</p>
 </div>
 
 
@@ -110651,7 +110652,7 @@ console.log(u8arr2u16arr('abc', { returnWithStateAndMsg: true }))
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Oct 12 2026 12:18:18 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 Tue Oct 13 2026 23:59:17 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wsemi",
-  "version": "1.9.13",
+  "version": "1.9.15",
   "main": "dist/wsemi.umd.js",
   "dependencies": {
     "@zumer/snapdom": "^3.3.0",
@@ -27,7 +27,7 @@
     "xxhash-wasm": "^1.1.0"
   },
   "devDependencies": {
-    "w-package-tools": "^1.1.16"
+    "w-package-tools": "^1.1.17"
   },
   "scripts": {
     "test": "mocha --parallel \"test/*.test.mjs\" --timeout 180000",

package/script.txt

@@ -6,7 +6,7 @@ node toolg/gPackageIndex.mjs
 node toolg/cleanFolder.mjs
 ./node_modules/.bin/jsdoc -c .jsdoc
 node toolg/gDocsExams.mjs
-node toolg/gDocsEditor.mjs
+#node toolg/gDocsEditor.mjs
 
 node toolfp/gDistRollup.mjs
 node toolparfor/gDistRollup.mjs

package/src/_execSpawnError.mjs

@@ -0,0 +1,41 @@
+import isestr from './isestr.mjs'
+
+
+//execProcess、execCli、execCliSession回報「無法啟動子進程」之共用核心, 獨立成模組以便直接餵錯誤物件做單元測試
+//  來源: node之spawn同步拋錯(EPERM、UNKNOWN、ENAMETOOLONG, 以及參數檢查之ERR_INVALID_ARG_VALUE、ERR_INVALID_ARG_TYPE等)與'error'事件(ENOENT、EACCES、EAGAIN、EMFILE、ENFILE)
+//  只讀code、message與errno, 不讀spawnargs(node對非同步錯誤所附之完整參數陣列, exec模式為整條指令列)、cmd等可能含參數之屬性
+//  有errno者為系統錯誤, message為「syscall 錯誤碼」, syscall為'spawn'或'spawn 執行檔', 不含參數, 原樣使用
+//  無errno者為node之參數檢查錯誤, message以「. Received 值」結尾, 值為該參數或環境變數之內容(node以inspect取前128字元), 故去除, 保留參數名稱(如args[2])以利判讀
+
+
+//execSpawnError, 輸入錯誤物件, 回傳{ code, message }, 缺code時為'UNKNOWN', 缺message時以code代之, 任何輸入皆不拋錯
+function execSpawnError(err) {
+    let code = ''
+    let message = ''
+    let errno = null
+    try {
+        code = err.code
+        message = err.message
+        errno = err.errno
+    }
+    catch (e) {}
+    if (!isestr(code)) {
+        code = 'UNKNOWN'
+    }
+    if (!isestr(message)) {
+        message = ''
+    }
+    if (typeof errno !== 'number') {
+        let i = message.indexOf('. Received ')
+        if (i >= 0) {
+            message = message.slice(0, i)
+        }
+    }
+    if (message === '') {
+        message = code
+    }
+    return { code, message }
+}
+
+
+export default execSpawnError