w-component-vue 2.5.28 → 2.5.29

package/test/unit-buildScripts.test.mjs

@@ -0,0 +1,491 @@
+import fs from 'fs'
+import path from 'path'
+import cp from 'child_process'
+import assert from 'assert'
+
+
+//unit-buildScripts: script.txt所執行之建置腳本之失敗回報契約(帳本「一、建置腳本」R-B1、R-EXIT、R-B2)
+//  每案於test/_tmp/unit-buildScripts/<案>/建沙箱, 複製toolg全部檔與所需最小輸入, 以沙箱為cwd用子行程執行腳本(同w-pksupdate以套件根目錄為cwd逐列執行)
+//  沙箱位於repo內, 腳本之裸import(w-package-tools、wsemi、lodash-es等)向上解析至repo之node_modules
+//  只斷言發布流程可觀察之結果: 離開碼、stderr之失敗原因、產物是否寫出; 離開碼不依賴Node之unhandled-rejections模式(R-EXIT另以warn模式驗)
+//  清空失敗以lock模擬: Windows以子行程之工作目錄占住子資料夾, 其他平台以唯讀子資料夾; 以root執行時無法模擬, 該等案例略過
+//  分辨力驗證用: 環境變數W_TOOLG_DIR可改由他處複製toolg(預設為工作區之toolg), 不改動工作區
+
+
+let NAME = 'unit-buildScripts'
+let root = path.resolve('.')
+let fdToolg = path.resolve(process.env.W_TOOLG_DIR || 'toolg')
+let fdBase = path.resolve('test/_tmp', NAME)
+let isWin = process.platform === 'win32'
+let canLock = isWin || !(typeof process.getuid === 'function' && process.getuid() === 0)
+let pkgJson = fs.readFileSync(path.join(root, 'package.json'))
+let OLD = '//old product\n'
+
+let vueOk = `<template>\r\n    <div class="x">ok</div>\r\n</template>\r\n\r\n<script>\r\nexport default {\r\n    name: 'x',\r\n    data: function() {\r\n        return { a: 1 }\r\n    },\r\n}\r\n</script>\r\n`
+let vueBad = vueOk.replace('return { a: 1 }', 'return { a: 1 ')
+
+
+function put(sbx, rel, content) {
+    let fp = path.join(sbx, rel)
+    fs.mkdirSync(path.dirname(fp), { recursive: true })
+    fs.writeFileSync(fp, content)
+}
+
+
+function patch(sbx, rel, fn) {
+    let fp = path.join(sbx, rel)
+    fs.writeFileSync(fp, fn(fs.readFileSync(fp, 'utf8')))
+}
+
+
+function list(sbx, rel) {
+    let fp = path.join(sbx, rel)
+    return fs.existsSync(fp) && fs.statSync(fp).isDirectory() ? fs.readdirSync(fp) : null
+}
+
+
+//mkSbx, 建立案例沙箱: 複製toolg全部檔(src/components/demolink.vue等亦引用toolg)與package.json(rollupFile讀取banner)
+function mkSbx(name) {
+    let sbx = path.join(fdBase, name)
+    fs.rmSync(sbx, { recursive: true, force: true })
+    fs.mkdirSync(path.join(sbx, 'toolg'), { recursive: true })
+    for (let f of fs.readdirSync(fdToolg)) {
+        fs.copyFileSync(path.join(fdToolg, f), path.join(sbx, 'toolg', f))
+    }
+    put(sbx, 'package.json', pkgJson)
+    return sbx
+}
+
+
+//run, 以沙箱為cwd執行沙箱內之腳本, 回傳離開碼與兩串流
+function run(sbx, rel, opt = {}) {
+    let r = cp.spawnSync(process.execPath, [path.join(sbx, rel), ...(opt.args || [])], {
+        cwd: sbx,
+        encoding: 'utf8',
+        env: { ...process.env, ...(opt.env || {}) },
+        timeout: 170000,
+    })
+    return { code: r.status, stdout: r.stdout || '', stderr: r.stderr || '' }
+}
+
+
+function waitExit(h) {
+    if (!h || h.exitCode !== null || h.signalCode !== null) {
+        return Promise.resolve()
+    }
+    return new Promise((resolve) => h.once('exit', resolve))
+}
+
+
+//lock, 使dir無法被清空(其下子資料夾sub刪不掉), 回傳{ release }; ms>0時於ms後自行解除
+//  解除由另一行程執行: 執行腳本之spawnSync期間本行程之計時器不會觸發
+//  Windows: 子行程以sub為工作目錄(Windows不可刪除他程序之當前目錄), 模擬檔案總管、終端機、防毒之占用
+//  其他平台: sub內放檔案並將sub設為唯讀, 其內檔案不可刪除
+function lock(dir, ms = 0) {
+    let sub = path.join(dir, 'sub')
+    fs.mkdirSync(sub, { recursive: true })
+    if (isWin) {
+        let h = cp.spawn(process.execPath, ['-e', `setTimeout(() => {}, ${ms || 60000})`], { cwd: sub, stdio: 'ignore' })
+        return {
+            release: async () => {
+                let p = waitExit(h)
+                if (h.exitCode === null && h.signalCode === null) {
+                    h.kill()
+                }
+                await p
+            },
+        }
+    }
+    fs.writeFileSync(path.join(sub, 'locked.txt'), 'x')
+    fs.chmodSync(sub, 0o555)
+    let h = null
+    if (ms > 0) {
+        h = cp.spawn(process.execPath, ['-e', `setTimeout(() => require('fs').chmodSync(${JSON.stringify(sub)}, 0o755), ${ms})`], { stdio: 'ignore' })
+    }
+    return {
+        release: async () => {
+            await waitExit(h)
+            try {
+                fs.chmodSync(sub, 0o755)
+            }
+            catch (err) {}
+        },
+    }
+}
+
+
+let sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+
+
+describe(NAME, function() {
+    this.timeout(180000)
+
+    after(function() {
+        fs.rmSync(fdBase, { recursive: true, force: true })
+        try {
+            fs.rmdirSync(path.resolve('test/_tmp')) //平行執行之其他檔尚在使用時保留
+        }
+        catch (err) {}
+    })
+
+
+    describe('第7列 gDistRollupWorkerFuncs(R-B1、R-EXIT)', function() {
+
+        let fpWorker = 'toolg/gDistRollupWorkerFuncs.mjs'
+        let names = ['convertToTreeWk', 'flattenTreeWk']
+
+        //mkWorkerSbx, 來源取自工作區src/js(不受本測試改動), 產物位置先放舊內容以辨識是否被改寫
+        let mkWorkerSbx = (name) => {
+            let sbx = mkSbx(name)
+            for (let n of names) {
+                put(sbx, `src/js/${n}.mjs`, fs.readFileSync(path.join(root, 'src/js', `${n}.mjs`)))
+                put(sbx, `src/js/${n}.wk.umd.js`, OLD)
+            }
+            return sbx
+        }
+
+        it('產製成功時離開碼為0, 兩個產物皆改寫為具預設匯出之ES module, 輸出不含invalid runin', function() {
+            let sbx = mkWorkerSbx('w-ok')
+            let r = run(sbx, fpWorker)
+            //R-B1: 成功即0
+            assert.strict.equal(r.code, 0, r.stdout + r.stderr)
+            //R-B1: 產物寫出(不再是舊內容), 為ES module且有預設匯出(WJsonView、WTree以import default引用)
+            for (let n of names) {
+                let c = fs.readFileSync(path.join(sbx, `src/js/${n}.wk.umd.js`), 'utf8')
+                assert.notStrictEqual(c, OLD, `${n} not rewritten`)
+                assert.ok(/export\s*\{\s*[\w$]+\s+as\s+default\s*\}/.test(c), `${n} has no default export`)
+            }
+            //成功路徑不印錯誤字樣(明給runin)
+            assert.ok((r.stdout + r.stderr).indexOf('invalid runin') < 0, 'prints invalid runin')
+        })
+
+        let fails = [
+            {
+                name: '來源不存在',
+                set: (sbx) => fs.rmSync(path.join(sbx, 'src/js/convertToTreeWk.mjs')),
+                reason: 'opt.fpSrc is not file',
+            },
+            {
+                name: '來源語法錯誤',
+                set: (sbx) => patch(sbx, 'src/js/flattenTreeWk.mjs', (c) => c + '\nlet = ;\n'),
+                reason: 'SyntaxError',
+            },
+            {
+                name: '來源無預設匯出',
+                set: (sbx) => patch(sbx, 'src/js/convertToTreeWk.mjs', (c) => c.replace('export default convertToTreeWk', 'export { convertToTreeWk }')),
+                reason: 'has no default export',
+            },
+            {
+                name: '來源引用不存在之相對路徑檔',
+                set: (sbx) => patch(sbx, 'src/js/convertToTreeWk.mjs', (c) => `import nx from './notExist.mjs'\nconsole.log(nx)\n` + c),
+                reason: 'Could not resolve',
+            },
+            {
+                name: '產物路徑為資料夾',
+                set: (sbx) => {
+                    fs.rmSync(path.join(sbx, 'src/js/convertToTreeWk.wk.umd.js'))
+                    fs.mkdirSync(path.join(sbx, 'src/js/convertToTreeWk.wk.umd.js'))
+                },
+                reason: 'EISDIR',
+            },
+        ]
+
+        for (let k = 0; k < fails.length; k++) {
+            let f = fails[k]
+            it(`${f.name}時離開碼非0, 且stderr含失敗原因`, function() {
+                let sbx = mkWorkerSbx(`w-fail-${k}`)
+                f.set(sbx)
+                let r = run(sbx, fpWorker)
+                //R-B1: 失敗即非0
+                assert.notStrictEqual(r.code, 0, r.stdout + r.stderr)
+                //R-B1: 失敗原因印至stderr
+                assert.ok(r.stderr.indexOf(f.reason) >= 0, `stderr lacks [${f.reason}]: ${r.stderr.slice(0, 500)}`)
+            })
+        }
+
+        for (let k of [0, 1]) {
+            let f = fails[k]
+            it(`${f.name}時於NODE_OPTIONS=--unhandled-rejections=warn下離開碼亦非0`, function() {
+                let sbx = mkWorkerSbx(`w-warn-${k}`)
+                f.set(sbx)
+                let r = run(sbx, fpWorker, { env: { NODE_OPTIONS: '--unhandled-rejections=warn' } })
+                //R-EXIT: 離開碼不依賴unhandled-rejections模式
+                assert.notStrictEqual(r.code, 0, r.stdout + r.stderr)
+            })
+        }
+
+    })
+
+
+    describe('cleanFolderStrict(R-B2)', function() {
+
+        //drive, 於沙箱內以子行程呼叫toolg/cleanFolderStrict.mjs清空指定路徑, 回傳成敗、耗時與清空後之內容
+        let drive = (sbx, target) => {
+            put(sbx, 'drive.mjs', [
+                `import fs from 'fs'`,
+                `import cleanFolderStrict from './toolg/cleanFolderStrict.mjs'`,
+                `let fd = process.argv[2]`,
+                `let out = { ok: false, msg: '', ms: 0, entries: null }`,
+                `let t0 = Date.now()`,
+                `try {`,
+                `    cleanFolderStrict(fd)`,
+                `    out.ok = true`,
+                `}`,
+                `catch (err) {`,
+                `    out.msg = String((err && err.message) || err)`,
+                `}`,
+                `out.ms = Date.now() - t0`,
+                `out.entries = fs.existsSync(fd) && fs.statSync(fd).isDirectory() ? fs.readdirSync(fd) : null`,
+                `console.log(JSON.stringify(out))`,
+                ``,
+            ].join('\n'))
+            let r = run(sbx, 'drive.mjs', { args: [target] })
+            let line = r.stdout.trim().split(/\r?\n/).pop()
+            assert.ok(line && line.startsWith('{'), `driver failed: ${r.stdout}${r.stderr}`.slice(0, 600))
+            return JSON.parse(line)
+        }
+
+        it('可清空時回傳, 資料夾存在且為空', function() {
+            let sbx = mkSbx('c-ok')
+            put(sbx, 'out/a.txt', 'a')
+            put(sbx, 'out/sub/b.txt', 'b')
+            let o = drive(sbx, 'out')
+            assert.ok(o.ok, o.msg)
+            assert.strict.deepEqual(o.entries, [])
+        })
+
+        it('資料夾不存在時建立為空資料夾', function() {
+            let sbx = mkSbx('c-new')
+            let o = drive(sbx, 'out')
+            assert.ok(o.ok, o.msg)
+            assert.strict.deepEqual(o.entries, [])
+        })
+
+        it('目標為檔案時重試後拋錯', function() {
+            let sbx = mkSbx('c-file')
+            put(sbx, 'out', 'iam-a-file')
+            let o = drive(sbx, 'out')
+            //R-B2: 非success即拋錯, 訊息含目標
+            assert.strict.equal(o.ok, false)
+            assert.ok(o.msg.indexOf('out') >= 0, o.msg)
+            //R-B2: 拋錯前重試10次、間隔300ms
+            assert.ok(o.ms >= 2700, `retried only ${o.ms}ms`)
+        })
+
+        it('目標不存在且無法建立(上層為檔案)時重試後拋錯', function() {
+            let sbx = mkSbx('c-nocreate')
+            put(sbx, 'afile', 'x')
+            let o = drive(sbx, 'afile/sub')
+            //R-B2: 內附wsemip於此分支回傳裸Error(無error鍵), 仍須判為失敗
+            assert.strict.equal(o.ok, false)
+            assert.ok(o.ms >= 2700, `retried only ${o.ms}ms`)
+        })
+
+        it('子資料夾持續無法刪除時重試後拋錯', async function() {
+            if (!canLock) {
+                this.skip() //以root執行時無法以唯讀造出刪除失敗
+            }
+            let sbx = mkSbx('c-locked')
+            put(sbx, 'out/a.txt', 'a')
+            let lk = lock(path.join(sbx, 'out'))
+            try {
+                await sleep(500)
+                let o = drive(sbx, 'out')
+                assert.strict.equal(o.ok, false)
+                assert.ok(o.ms >= 2700, `retried only ${o.ms}ms`)
+            }
+            finally {
+                await lk.release()
+            }
+        })
+
+        it('暫時無法刪除而於重試期間解除時清空成功', async function() {
+            if (!canLock) {
+                this.skip()
+            }
+            let sbx = mkSbx('c-transient')
+            put(sbx, 'out/a.txt', 'a')
+            let lk = lock(path.join(sbx, 'out'), 1200)
+            try {
+                await sleep(500)
+                let o = drive(sbx, 'out')
+                //R-B2: 重試使暫時性占用不致誤中止
+                assert.ok(o.ok, o.msg)
+                assert.strict.deepEqual(o.entries, [])
+                assert.ok(o.ms >= 300, `no retry happened (${o.ms}ms)`)
+            }
+            finally {
+                await lk.release()
+            }
+        })
+
+    })
+
+
+    describe('第4列 cleanFolder(R-B2)', function() {
+
+        it('dist與docs皆可清空時離開碼為0, 兩者皆為空資料夾', function() {
+            let sbx = mkSbx('l4-ok')
+            put(sbx, 'dist/a.txt', 'a')
+            put(sbx, 'dist/sub/b.txt', 'b')
+            put(sbx, 'docs/c.html', 'c')
+            put(sbx, 'docs/sub2/d.html', 'd')
+            let r = run(sbx, 'toolg/cleanFolder.mjs')
+            assert.strict.equal(r.code, 0, r.stdout + r.stderr)
+            assert.strict.deepEqual([list(sbx, 'dist'), list(sbx, 'docs')], [[], []])
+        })
+
+        it('dist為檔案時離開碼非0, 且stderr含dist', function() {
+            let sbx = mkSbx('l4-file')
+            put(sbx, 'dist', 'iam-a-file')
+            let r = run(sbx, 'toolg/cleanFolder.mjs')
+            //R-B2: 清空失敗即非0, 原因印出
+            assert.notStrictEqual(r.code, 0, r.stdout + r.stderr)
+            assert.ok(r.stderr.indexOf('dist') >= 0, r.stderr.slice(0, 500))
+        })
+
+        it('dist內子資料夾無法刪除而清空不了時離開碼非0', async function() {
+            if (!canLock) {
+                this.skip()
+            }
+            let sbx = mkSbx('l4-locked')
+            put(sbx, 'dist/a.txt', 'a')
+            put(sbx, 'dist/zz-stale.txt', 'stale')
+            put(sbx, 'docs/c.html', 'c')
+            let lk = lock(path.join(sbx, 'dist'))
+            try {
+                await sleep(500)
+                let r = run(sbx, 'toolg/cleanFolder.mjs')
+                assert.notStrictEqual(r.code, 0, r.stdout + r.stderr)
+            }
+            finally {
+                await lk.release()
+            }
+        })
+
+    })
+
+
+    describe('第11列 gExtractHtml(R-B2)', function() {
+
+        let mkExtractSbx = (name) => {
+            let sbx = mkSbx(name)
+            put(sbx, 'src/AppZoneWBadge.vue', fs.readFileSync(path.join(root, 'src/AppZoneWBadge.vue')))
+            return sbx
+        }
+
+        it('可清空時離開碼為0, 舊頁不殘留且範例頁皆產出', function() {
+            let sbx = mkExtractSbx('l11-ok')
+            put(sbx, 'test-html/zz-stale.html', 'stale')
+            let r = run(sbx, 'toolg/gExtractHtml.mjs')
+            assert.strict.equal(r.code, 0, r.stdout + r.stderr)
+            let hs = list(sbx, 'test-html')
+            assert.ok(hs.indexOf('zz-stale.html') < 0, 'stale page remains')
+            assert.ok(hs.length > 0 && hs.every((f) => f.startsWith('w-badge_')), JSON.stringify(hs))
+        })
+
+        it('test-html內子資料夾無法刪除而清空不了時離開碼非0', async function() {
+            if (!canLock) {
+                this.skip()
+            }
+            let sbx = mkExtractSbx('l11-html-locked')
+            put(sbx, 'test-html/zz-stale.html', 'stale')
+            let lk = lock(path.join(sbx, 'test-html'))
+            try {
+                await sleep(500)
+                let r = run(sbx, 'toolg/gExtractHtml.mjs')
+                //R-B2: 清空失敗即非0, 不以殘留之舊頁續行(第12列會把test-html全部複製進docs/examples)
+                assert.notStrictEqual(r.code, 0, r.stdout + r.stderr)
+            }
+            finally {
+                await lk.release()
+            }
+        })
+
+        it('test-action內子資料夾無法刪除而清空不了時離開碼非0', async function() {
+            if (!canLock) {
+                this.skip()
+            }
+            let sbx = mkExtractSbx('l11-action-locked')
+            put(sbx, 'test-action/zz-stale.action.json', '[]')
+            let lk = lock(path.join(sbx, 'test-action'))
+            try {
+                await sleep(500)
+                let r = run(sbx, 'toolg/gExtractHtml.mjs')
+                assert.notStrictEqual(r.code, 0, r.stdout + r.stderr)
+            }
+            finally {
+                await lk.release()
+            }
+        })
+
+    })
+
+
+    describe('兄弟列之回歸守門(R-B1)', function() {
+
+        it('第2列 modifyReadme: README.md不存在時離開碼非0', function() {
+            let sbx = mkSbx('s2')
+            let r = run(sbx, 'toolg/modifyReadme.mjs')
+            assert.notStrictEqual(r.code, 0, r.stdout + r.stderr)
+        })
+
+        it('第9列 gDistApp: App.vue語法錯誤時離開碼非0', function() {
+            let sbx = mkSbx('s9')
+            put(sbx, 'src/App.vue', vueBad)
+            let r = run(sbx, 'toolg/gDistApp.mjs')
+            assert.notStrictEqual(r.code, 0, r.stdout + r.stderr)
+        })
+
+        it('第11列 gExtractHtml: AppZone檔無template時離開碼非0', function() {
+            let sbx = mkSbx('s11')
+            put(sbx, 'src/AppZoneWBroken.vue', '<script>\r\nexport default {}\r\n</script>\r\n')
+            let r = run(sbx, 'toolg/gExtractHtml.mjs')
+            assert.notStrictEqual(r.code, 0, r.stdout + r.stderr)
+        })
+
+        it('第12列 gDocExams: test-html不存在時離開碼非0', function() {
+            let sbx = mkSbx('s12')
+            fs.mkdirSync(path.join(sbx, 'docs'), { recursive: true }) //前列已建立docs
+            let r = run(sbx, 'toolg/gDocExams.mjs')
+            assert.notStrictEqual(r.code, 0, r.stdout + r.stderr)
+        })
+
+        it('第14列 gMergeComps: src/components不存在時離開碼非0', function() {
+            let sbx = mkSbx('s14')
+            fs.mkdirSync(path.join(sbx, 'src'), { recursive: true })
+            let r = run(sbx, 'toolg/gMergeComps.mjs')
+            assert.notStrictEqual(r.code, 0, r.stdout + r.stderr)
+        })
+
+        it('第15列 gDistRollupComps: 元件語法錯誤時離開碼非0', function() {
+            let sbx = mkSbx('s15')
+            put(sbx, 'src/components/WComponentVue.vue', vueBad)
+            let r = run(sbx, 'toolg/gDistRollupComps.mjs')
+            assert.notStrictEqual(r.code, 0, r.stdout + r.stderr)
+        })
+
+        it('第15列 gDistRollupComps: 建置成功時離開碼為0, 輸出不含invalid runin', function() {
+            let sbx = mkSbx('s15-ok')
+            put(sbx, 'src/components/WComponentVue.vue', vueOk)
+            let r = run(sbx, 'toolg/gDistRollupComps.mjs')
+            assert.strict.equal(r.code, 0, r.stdout + r.stderr)
+            assert.ok(fs.existsSync(path.join(sbx, 'dist/w-component-vue.umd.js')), 'dist not written')
+            //成功路徑不印錯誤字樣(明給runin)
+            assert.ok((r.stdout + r.stderr).indexOf('invalid runin') < 0, 'prints invalid runin')
+        })
+
+    })
+
+
+    describe('暫存檔不入版控', function() {
+
+        it('w-package-tools於cwd寫入之temp-*暫存檔被.gitignore排除', function() {
+            //rollupCode於cwd寫入temp-<id>-<name>.js, 行程中止或刪除失敗時殘留, 不得被git add . -A提交
+            let r = cp.spawnSync('git', ['check-ignore', '-q', 'temp-0123abcd-convertToTreeWk.js'], { cwd: root })
+            assert.strict.equal(r.status, 0)
+        })
+
+    })
+
+})

package/test/unit-workerFuncs.test.mjs

@@ -0,0 +1,121 @@
+import fs from 'fs'
+import path from 'path'
+import assert from 'assert'
+import { bundleEntry, removeBundle, launchBrowser, openPage } from './tools/e2e-setup.mjs'
+import { genCases } from './tools/workerFuncsCases.mjs'
+
+
+//unit-workerFuncs: 受追蹤之worker產物之功能契約(帳本「一、建置腳本」R-B3)
+//  worker產物以blob URL建立Web Worker, 只能於瀏覽器執行, 故以真Chromium(test/tools/e2e-setup.mjs之唯一launch出口)載入;
+//  呼叫為函數層級(page.evaluate), 非使用者操作, 故屬unit-而非e2e-
+//  測試頁由webpack打包: 入口於before內寫入test/_tmp(import產物、wsemi之非worker版與共用案例表), 以setContent載入, 不起伺服器
+//  每個案例一個全新瀏覽器: worker版與非worker版各以新產生之輸入呼叫, 斷言結果深度相等(含鍵順序), 呼叫結束後無殘留worker、無頁面錯誤
+//  分辨力驗證用: 環境變數W_WORKER_DIR可改由他處取worker產物(預設為受追蹤之src/js), 不改動src/js
+
+
+let NAME = 'unit-workerFuncs'
+let root = path.resolve('.')
+let fdWorker = path.resolve(process.env.W_WORKER_DIR || 'src/js')
+let fdEntry = path.resolve('test/_tmp', `${NAME}-entry`)
+
+
+//rel, 入口檔至目標之相對import路徑(webpack以/為分隔)
+function rel(fp) {
+    let r = path.relative(fdEntry, fp).replace(/\\/g, '/')
+    return r.startsWith('.') ? r : `./${r}`
+}
+
+
+function writeEntry() {
+    let c = `
+import { genCases, deepEqual, keyOrder } from '${rel(path.join(root, 'test/tools/workerFuncsCases.mjs'))}'
+import convertToTree from 'wsemi/src/convertToTree.mjs'
+import flattenTree from 'wsemi/src/flattenTree.mjs'
+import convertToTreeWk from '${rel(path.join(fdWorker, 'convertToTreeWk.wk.umd.js'))}'
+import flattenTreeWk from '${rel(path.join(fdWorker, 'flattenTreeWk.wk.umd.js'))}'
+
+window.__t = {
+    genCases,
+    deepEqual,
+    keyOrder,
+    ref: { convertToTree, flattenTree },
+    wk: { convertToTree: convertToTreeWk, flattenTree: flattenTreeWk },
+}
+`
+    fs.mkdirSync(fdEntry, { recursive: true })
+    let fp = path.join(fdEntry, 'entry.mjs')
+    fs.writeFileSync(fp, c, 'utf8')
+    return fp
+}
+
+
+describe(NAME, function() {
+    this.timeout(180000)
+
+    let bundle = ''
+    before(async function() {
+        this.timeout(600000)
+        bundle = await bundleEntry(NAME, writeEntry())
+    })
+    after(function() {
+        fs.rmSync(fdEntry, { recursive: true, force: true })
+        removeBundle(NAME)
+    })
+
+    let browser = null
+    beforeEach(async function() {
+        this.timeout(600000) //首次啟動時可能下載瀏覽器
+        browser = await launchBrowser()
+    })
+    afterEach(async function() {
+        if (browser) {
+            await browser.close()
+        }
+        browser = null
+    })
+
+    for (let cs of genCases()) {
+        it(`${cs.name}: worker版與非worker版結果深度相等且鍵順序相同, 呼叫後無殘留worker`, async function() {
+            let { ctx, page, logs } = await openPage(browser, bundle)
+
+            let r = await page.evaluate(async (name) => {
+                let t = window.__t
+                let a = t.genCases().find((v) => v.name === name)
+                let b = t.genCases().find((v) => v.name === name)
+                let out = { status: '', err: '', equal: false, keyOrderEqual: false }
+                let vWk
+                try {
+                    vWk = await Promise.race([
+                        t.wk[a.fn](a.data, a.opt),
+                        new Promise((resolve, reject) => setTimeout(() => reject(new Error('timeout(60s)')), 60000)),
+                    ])
+                    out.status = 'resolved'
+                }
+                catch (err) {
+                    out.status = 'rejected'
+                    out.err = String((err && err.message) || err)
+                    return out
+                }
+                let vRef = t.ref[b.fn](b.data, b.opt)
+                out.equal = t.deepEqual(vWk, vRef)
+                out.keyOrderEqual = t.keyOrder(vWk) === t.keyOrder(vRef)
+                return out
+            }, cs.name)
+
+            //R-B3: 可結構化複製之輸入, worker版須照常回傳(不reject、不懸置)
+            assert.strict.equal(r.status, 'resolved', `worker rejected: ${r.err}`)
+            //R-B3: 結果與非worker版深度相等
+            assert.ok(r.equal, 'worker result differs from non-worker result')
+            //R-B3: 鍵順序相同(元件依鍵順序顯示)
+            assert.ok(r.keyOrderEqual, 'key order differs from non-worker result')
+
+            //R-B3: 一般呼叫結束後不殘留worker(每次呼叫新建並於結束時中止)
+            await page.waitForTimeout(300)
+            assert.strict.equal(page.workers().length, 0)
+
+            assert.strict.deepEqual(logs.pageerror, [])
+            await ctx.close()
+        })
+    }
+
+})

package/toolg/cleanFolder.mjs

@@ -1,5 +1,5 @@
-import cleanFolder from 'w-package-tools/src/cleanFolder.mjs'
-
-
-cleanFolder('dist')
-cleanFolder('docs')
+import cleanFolderStrict from './cleanFolderStrict.mjs'
+
+
+cleanFolderStrict('dist')
+cleanFolderStrict('docs')

package/toolg/cleanFolderStrict.mjs

@@ -0,0 +1,59 @@
+import fs from 'fs'
+import cleanFolder from 'w-package-tools/src/cleanFolder.mjs'
+
+
+//cleanFolderStrict: 清空資料夾(不存在則建立), 失敗時重試, 仍失敗即拋錯, 供建置腳本清空dist、docs、test-html、test-action
+//  w-package-tools之cleanFolder(內附wsemip之fsCleanFolder)失敗時不拋錯而回傳結果, 且形狀不一: 多為{ error }, 無法建立時為裸Error, 故以「非success」判定失敗
+//  重試比照w-pksupdate之removeTarget(10次、間隔300ms), Windows之防毒、索引、檔案總管等暫時性占用不致誤中止
+//  同步執行(以Atomics.wait等待), 呼叫端維持同步; 拋錯即未捕捉例外, 腳本以離開碼1結束, 不依賴unhandled-rejections模式
+
+
+let retries = 10
+let delay = 300
+
+
+function sleepSync(ms) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms)
+}
+
+
+function isEmptyFolder(fd) {
+    try {
+        return fs.statSync(fd).isDirectory() && fs.readdirSync(fd).length === 0
+    }
+    catch (err) {
+        return false
+    }
+}
+
+
+function getMsg(r) {
+    if (r instanceof Error) {
+        return r.message
+    }
+    if (r && r.error !== undefined) {
+        return (r.error && r.error.message) || String(r.error)
+    }
+    if (r && r.success) {
+        return 'folder is not empty after cleaning'
+    }
+    return String(r)
+}
+
+
+function cleanFolderStrict(fd) {
+    let r = null
+    for (let i = 0; i <= retries; i++) {
+        if (i > 0) {
+            sleepSync(delay)
+        }
+        r = cleanFolder(fd)
+        if (r && r.success && isEmptyFolder(fd)) {
+            return r
+        }
+    }
+    throw new Error(`cleanFolderStrict: can not clean folder[${fd}] after ${retries} retries: ${getMsg(r)}`)
+}
+
+
+export default cleanFolderStrict

package/toolg/gDistRollupComps.mjs

@@ -11,6 +11,7 @@ rollupFiles({
     fdSrc,
     fdTar,
     nameDistType: 'kebabCase',
+    runin: 'browser',
     globals: {
         'vue': 'Vue',
     },