Methods
addVersion(fnPks)
- Description:
自動添加package.json內版本補丁號
- Source:
Parameters:
| Name | Type | Default | Description |
|---|---|---|---|
fnPks |
String |
./package.json
|
輸入package.json位置路徑字串 |
(async) extractHtml(optopt)
- Description:
產生瀏覽範例用的html檔
- Source:
Parameters:
| Name | Type | Attributes | Default | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
opt |
Object |
<optional> |
{}
|
輸入設定物件,預設{} Properties
|
getPks(fnopt) → {Object}
- Description:
取得package.json資料物件
- Source:
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
fn |
String |
<optional> |
'./package.json'
|
輸入package.json路徑字串 |
Returns:
回傳資料物件
- Type
- Object
getReadme(fnopt) → {Object}
- Description:
讀取readme資料物件
- Source:
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
fn |
String |
<optional> |
'./README.md'
|
輸入readme檔案路徑字串 |
Returns:
回傳readme資料物件
- Type
- Object
modifyReadme(fnRMopt)
- Description:
更新readme內cdn連結為最新版本
- Source:
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
fnRM |
String |
<optional> |
'./README.md'
|
輸入readme檔案路徑字串 |
(async) parfor(fpWorker, jobs, optopt) → {Promise}
- Description:
輕量持久 worker pool 平行執行器,用原生 worker_threads 把 CPU 密集計算分散到多核心,免任何編譯步驟
機制: · 免編譯 ESM worker:new Worker(URL)直接跑 .mjs 檔,worker 內可正常 import 專案模組與 node_modules。 · 持久 pool:每個 worker 只建立一次(import core、模組級預計算、initData 注入都只付一次),跑完整批工作才 terminate;對比「每批新建 worker + eval bundle」省去重複啟動 / 解析 / 預計算成本。 · 動態派工:閒置的 worker 自動領取下一個 job(內建負載均衡,不需 caller 預先平衡 job 順序)。 · lifecycle 對稱:全部完成(或失敗)一律 terminate 所有 worker,直跑 node 不會 hang。
worker 協定(worker entry 檔須遵守):
- 經 workerData 收 initData(一次)。
- 收 { k, job } → 計算 → 回 { k, r }。
- 單 job 失敗回 { k, err }(err 為字串)→ 不炸批,主程序印錯後續跑。
- worker 載入 / init 失敗(import 錯、workerData 處理 throw)→ 整批 fail-fast 拋錯(不默跑)。
適用:CPU 密集的純計算(大量迴圈、數值運算、回測撮合),且工作可拆成多個彼此獨立的 job 不適用:I/O 密集任務(讀檔、網路請求),這類用單執行緒 Promise 並行即可,開 worker 反而多付啟動與傳輸成本
- Source:
Parameters:
| Name | Type | Attributes | Default | Description | |||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
fpWorker |
String | URL | 輸入 worker entry 之 file URL(建議 new URL('./xxx_worker.mjs', import.meta.url))或絕對路徑字串 |
|||||||||||||||||||||||||||
jobs |
Array | 輸入工作陣列,每個 job 經 postMessage 結構化複製傳入 worker |
|||||||||||||||||||||||||||
opt |
Object |
<optional> |
{}
|
輸入設定物件,預設 {} Properties
|
Returns:
回傳 Promise,resolve 時:opt.returnResult 為 true 回傳 results 陣列(依 job 索引對位),否則回傳 undefined
- Type
- Promise
(async) rollupCode(codeSrc, opt)
- Description:
使用rollup轉譯程式碼
- Source:
Parameters:
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
codeSrc |
String | 輸入程式碼字串 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
opt |
Object | 輸入設定物件 Properties
|
(async) rollupFile(opt)
- Description:
使用rollup轉譯檔案
- Source:
Parameters:
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
opt |
Object | 輸入設定物件 Properties
|
(async) rollupFiles(opt)
- Description:
使用rollup轉譯檔案
- Source:
Parameters:
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
opt |
Object | 輸入設定物件 Properties
|
(async) rollupParfor(opt)
- Description:
使用rollup轉譯外部指定的核心分析程式碼檔案,並封裝至前端web worker與後端worker內
- Source:
Parameters:
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
opt |
Object | 輸入設定物件 Properties
|
(async) rollupVueToHtml(srcopt, taropt, optopt)
- Description:
使用rollup轉譯Vue檔案並產生瀏覽用的html檔
- Source:
Parameters:
| Name | Type | Attributes | Default | Description | |||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
src |
String |
<optional> |
'./src/App.vue'
|
輸入欲打包Vue檔案(*.vue)的位置字串,預設'./src/App.vue' |
|||||||||||||||||||||||||||||||||||
tar |
String |
<optional> |
'./docs/examples/app.html'
|
輸入輸出html的位置字串,並於該目錄下會出現打包後的js檔與map檔,預設'./docs/examples/app.html' |
|||||||||||||||||||||||||||||||||||
opt |
Object |
<optional> |
{}
|
輸入其他設定物件,預設{} Properties
|
(async) rollupWorker(opt)
- Description:
使用rollup轉譯檔案,並封裝至前端web worker與後端worker內
- Source:
Parameters:
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
opt |
Object | 輸入設定物件 Properties
|
(async) rollupWorkerCore(opt)
- Description:
使用rollup轉譯檔案,並封裝至前端web worker內或後端nodejs worker內
- Source:
Parameters:
| Name | Type | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
opt |
Object | 輸入設定物件 Properties
|
setPks(pks, fnopt)
- Description:
儲存資料至package.json
- Source:
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
pks |
Object | 輸入package.json資料物件 |
||
fn |
String |
<optional> |
'./package.json'
|
輸入package.json路徑字串 |