w-dwdata-hub 1.0.13 → 1.0.15

package/docs/fetchAisixiang.mjs.html

@@ -124,7 +124,7 @@ function getCfg(opt = {}) {
         maxPages = Math.min(cint(maxPages), MAX_PAGES)
     }
 
-    return { baseUrl, showLog: optFetch.showLog, pageDelayMs, maxPages, optFetch }
+    return { baseUrl, useShowLog: optFetch.useShowLog, pageDelayMs, maxPages, optFetch }
 }
 
 
@@ -302,7 +302,7 @@ async function fetchAllSearchPages(buildUrl, parser, cfg) {
     for (let page = 1; page <= cfg.maxPages; page++) {
 
         let url = buildUrl(page)
-        if (cfg.showLog) {
+        if (cfg.useShowLog) {
             process.stderr.write(`[info] fetching page ${page}${totalPages > 1 ? `/${totalPages}` : ''} ...\n`)
         }
         let html = await fetchWithRetry(url, cfg.optFetch)
@@ -315,7 +315,7 @@ async function fetchAllSearchPages(buildUrl, parser, cfg) {
         let items = parser(html, cfg.baseUrl)
         let fresh = items.filter((it) => !seen.has(it.aid))
         if (fresh.length === 0) {
-            if (cfg.showLog) {
+            if (cfg.useShowLog) {
                 process.stderr.write(`[info] page ${page} 無新項目，停止翻頁\n`)
             }
             break
@@ -348,7 +348,7 @@ async function fetchAllSearchPages(buildUrl, parser, cfg) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳作者物件陣列，各物件為{slug,name}
  * @example
  *
@@ -428,7 +428,7 @@ function lookupAuthor(authors, name) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳主題物件陣列，各物件為{id,name,category}
  * @example
  *
@@ -521,7 +521,7 @@ function lookupTopic(topics, name) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{status,site,mode,query,resolved,fetched_at,count,items}，name與slug皆未給時reject回傳錯誤物件
  * @example
  *
@@ -563,7 +563,7 @@ async function fetchAuthorArticles(opt = {}) {
 
     if (!usedSlug) {
 
-        if (cfg.showLog) {
+        if (cfg.useShowLog) {
             process.stderr.write('[info] fetching authors list from /thinktank/ ...\n')
         }
         let authors = await fetchAuthorsList(opt)
@@ -631,7 +631,7 @@ async function fetchAuthorArticles(opt = {}) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{status,site,mode,query,resolved,fetched_at,count,items}，keyword非有效字串時reject回傳錯誤物件
  * @example
  *
@@ -703,7 +703,7 @@ async function fetchKeywordArticles(keyword, opt = {}) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{status,site,mode,query,resolved,fetched_at,count,items}，keyword非有效字串時reject回傳錯誤物件
  * @example
  *
@@ -777,7 +777,7 @@ async function fetchTitleArticles(keyword, opt = {}) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{status,site,mode,query,resolved,fetched_at,count,items}，keyword與id皆未給時reject回傳錯誤物件
  * @example
  *
@@ -819,7 +819,7 @@ async function fetchTopicArticles(opt = {}) {
 
     if (!topicId) {
 
-        if (cfg.showLog) {
+        if (cfg.useShowLog) {
             process.stderr.write('[info] fetching topics list from /zhuanti/ ...\n')
         }
         let topics = await fetchTopicsList(opt)
@@ -894,7 +894,7 @@ async function fetchTopicArticles(opt = {}) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{status,site,mode,url,title,chars,markdown}，aid與url皆未給或解析失敗時reject回傳錯誤物件
  * @example
  *
@@ -1025,7 +1025,7 @@ export default fetchAisixiang
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 19:16:45 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 Sep 13 2026 14:29:36 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/fetchCnyes.mjs.html

@@ -99,7 +99,7 @@ let DEFAULT_DAYS_BACK = 10
  * @param {Integer} [opt.maxRetries=10] 輸入最大重試次數整數，含初始共執行maxRetries+1次，預設10
  * @param {Integer} [opt.baseDelayMs=5000] 輸入重試之線性退避基礎毫秒整數，預設5000
  * @param {Integer} [opt.maxDelayMs=30000] 輸入重試之線性退避上限毫秒整數，預設30000
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳新聞物件陣列，各物件為{time,title,link}，抓取失敗時reject回傳錯誤物件
  * @example
  *
@@ -164,13 +164,13 @@ async function fetchCnyes(opt = {}) {
 
     //optFetch
     let optFetch = getOptFetch(opt, DFLT)
-    let showLog = optFetch.showLog
+    let useShowLog = optFetch.useShowLog
 
     //now, startAt
     let now = Math.floor(Date.now() / 1000)
     let startAt = now - 86400 * daysBack
 
-    if (showLog) {
+    if (useShowLog) {
         console.log('Starting to fetch Anue (tw_stock) news...')
     }
 
@@ -193,14 +193,14 @@ async function fetchCnyes(opt = {}) {
         //items
         let items = get(data, 'items.data')
         if (!isearr(items)) {
-            if (showLog) {
+            if (useShowLog) {
                 console.log('No more items found.')
             }
             break
         }
 
         allItems = allItems.concat(items)
-        if (showLog) {
+        if (useShowLog) {
             console.log(`Page ${page}: Fetched ${items.length} items. Total so far: ${allItems.length}`)
         }
         page++
@@ -211,7 +211,7 @@ async function fetchCnyes(opt = {}) {
 
     //finalItems
     let finalItems = allItems.slice(0, targetTotal)
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Total items collected: ${finalItems.length}`)
     }
 
@@ -219,7 +219,7 @@ async function fetchCnyes(opt = {}) {
 
         //time, 單筆publishAt缺漏或異常時退回空字串並記錄, 保留title與link避免拖垮其餘正常新聞
         let time = toDatetimeUTC8(get(item, 'publishAt', 0))
-        if (time === '' && showLog) {
+        if (time === '' && useShowLog) {
             console.warn(`[fetch-cnyes] 時間格式化失敗(newsId=${get(item, 'newsId', '')}, publishAt=${get(item, 'publishAt', '')}) — 該筆time退回空字串`)
         }
 
@@ -247,7 +247,7 @@ export default fetchCnyes
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 19:16:45 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 Sep 13 2026 14:29:36 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/fetchGuancha.mjs.html

@@ -160,10 +160,10 @@ function getCfg(opt = {}) {
         timeoutMs = cint(timeoutMs)
     }
 
-    //showLog
-    let showLog = get(opt, 'showLog')
-    if (!isbol(showLog)) {
-        showLog = true
+    //useShowLog
+    let useShowLog = get(opt, 'useShowLog')
+    if (!isbol(useShowLog)) {
+        useShowLog = true
     }
 
     //optFetch
@@ -190,7 +190,7 @@ function getCfg(opt = {}) {
         maxPages = Math.min(cint(maxPages), MAX_PAGES)
     }
 
-    return { baseUrl, showLog, pageDelayMs, maxPages, optFetch }
+    return { baseUrl, useShowLog, pageDelayMs, maxPages, optFetch }
 }
 
 
@@ -363,7 +363,7 @@ async function fetchAllListPages(slug, cfg) {
     for (let page = 1; page <= cfg.maxPages; page++) {
 
         let url = `${cfg.baseUrl}/${slug}/list_${page}.shtml`
-        if (cfg.showLog) {
+        if (cfg.useShowLog) {
             process.stderr.write(`[info] fetching ${slug} list_${page} ...\n`)
         }
 
@@ -376,7 +376,7 @@ async function fetchAllListPages(slug, cfg) {
             if (page === 1) {
                 throw err
             }
-            if (cfg.showLog) {
+            if (cfg.useShowLog) {
                 process.stderr.write(`[info] page ${page} fetch error (assumed end of list): ${err.message}\n`)
             }
             break
@@ -389,7 +389,7 @@ async function fetchAllListPages(slug, cfg) {
                 err.reason = 'redirected-to-homepage'
                 throw err
             }
-            if (cfg.showLog) {
+            if (cfg.useShowLog) {
                 process.stderr.write(`[info] page ${page} 被導向首頁，視為到底，停止翻頁\n`)
             }
             break
@@ -400,7 +400,7 @@ async function fetchAllListPages(slug, cfg) {
         let items = parseListPage(html, cfg.baseUrl)
         let fresh = items.filter((it) => !seen.has(it.url))
         if (fresh.length === 0) {
-            if (cfg.showLog) {
+            if (cfg.useShowLog) {
                 process.stderr.write(`[info] page ${page} 無新項目，停止翻頁\n`)
             }
             break
@@ -431,7 +431,7 @@ async function fetchAllListPages(slug, cfg) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳作者物件陣列，各物件為{slug,name,letter}
  * @example
  *
@@ -524,7 +524,7 @@ function lookupTopic(name) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{status,site,mode,query,resolved,fetched_at,count,items}，name與slug皆未給時reject回傳錯誤物件
  * @example
  *
@@ -565,7 +565,7 @@ async function fetchAuthorArticles(opt = {}) {
 
     if (!resolvedSlug) {
 
-        if (cfg.showLog) {
+        if (cfg.useShowLog) {
             process.stderr.write('[info] fetching authors index from / ...\n')
         }
         let authors = await fetchAuthorsList(opt)
@@ -732,7 +732,7 @@ async function fetchTitleArticles(keyword, opt = {}) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{status,site,mode,query,resolved,fetched_at,count,items}，name與slug皆未給時reject回傳錯誤物件
  * @example
  *
@@ -837,7 +837,7 @@ async function fetchTopicArticles(opt = {}) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，預設5
  * @param {Integer} [opt.pageDelayMs=1000] 輸入翻頁之頁間延遲毫秒整數，預設1000
  * @param {Integer} [opt.maxPages=50] 輸入翻頁上限正整數，上限為50，預設50
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{status,site,mode,url,title,author,published,chars,markdown}，url非有效字串時reject回傳錯誤物件
  * @example
  *
@@ -990,7 +990,7 @@ export default fetchGuancha
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 19:16:45 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 Sep 13 2026 14:29:36 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/fetchHackerNews.mjs.html

@@ -88,7 +88,7 @@ let CONCURRENCY = 10
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，含初始共執行maxRetries+1次，預設5
  * @param {Integer} [opt.baseDelayMs=3000] 輸入重試之線性退避基礎毫秒整數，預設3000
  * @param {Integer} [opt.maxDelayMs=15000] 輸入重試之線性退避上限毫秒整數，預設15000
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示重試訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示重試訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳文章物件陣列，各物件為{url,time,title,description,from}，抓取ID清單失敗時reject回傳錯誤物件
  * @example
  *
@@ -176,7 +176,7 @@ export default fetchHackerNews
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 19:16:45 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 Sep 13 2026 14:29:36 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/fetchMoneydj.mjs.html

@@ -100,7 +100,7 @@ let REG_TIME = /^(\d{2}\/\d{2}\s+\d{2}:\d{2}|\d{2}:\d{2}|昨\s*\d{2}:\d{2})$/
  * @param {Integer} [opt.maxDelayMs=30000] 輸入重試最大延遲毫秒整數，預設30000
  * @param {Integer} [opt.pageDelayMs] 輸入頁間延遲毫秒整數，未給時採隨機1000至3000毫秒
  * @param {Function} [opt.onPageDone] 輸入每頁完成時之回呼函數，傳入(pageIndex,itemCount,totalPages)
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳新聞物件陣列，各物件為{time,title,link}，抓取到0筆時reject回傳錯誤物件
  * @example
  *
@@ -144,7 +144,7 @@ async function fetchMoneydj(opt = {}) {
 
     //optFetch
     let optFetch = getOptFetch(opt, DFLT)
-    let showLog = optFetch.showLog
+    let useShowLog = optFetch.useShowLog
 
     //pageDelayMs, 頁間隨機延遲毫秒
     let pageDelayMs = get(opt, 'pageDelayMs')
@@ -198,7 +198,7 @@ async function fetchMoneydj(opt = {}) {
             items = await fetchPage(i)
         }
         catch (err) {
-            if (showLog) {
+            if (useShowLog) {
                 console.warn(`[Page ${i}] 抓取失敗，已跳過：${err.message}`)
             }
             continue
@@ -238,7 +238,7 @@ export default fetchMoneydj
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 19:16:45 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 Sep 13 2026 14:29:36 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/fetchMops.mjs.html

@@ -166,7 +166,7 @@ async function fetchTargetWithRetry(page, target, cfg) {
         }
 
         let ms = Math.min(cfg.baseDelayMs * attempt, cfg.maxDelayMs)
-        if (cfg.showLog) {
+        if (cfg.useShowLog) {
             console.warn(`[${target.name}][Retry ${attempt}/${cfg.maxRetries}] ${data.error} — 等待 ${ms / 1000}s 後重試...`)
         }
         await delay(ms)
@@ -188,7 +188,7 @@ async function fetchTargetWithRetry(page, target, cfg) {
  * @param {String} [opt.pageUrl='https://mops.twse.com.tw/mops/#/web/t146sb10'] 輸入MOPS重大訊息頁網址字串，供測試或改指向鏡像時覆寫
  * @param {String} [opt.apiUrl='https://mops.twse.com.tw/mops/api/t146sb10'] 輸入MOPS查詢API網址字串，供測試或改指向鏡像時覆寫
  * @param {Integer} [opt.maxRetries=10] 輸入最大重試次數整數，含初始共執行maxRetries+1次，預設10
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{results,hasError}，results各筆為{market,marketKind,data,error,timestamp}，瀏覽器啟動失敗時reject回傳錯誤物件
  * @example
  *
@@ -230,10 +230,10 @@ async function fetchMops(opt = {}) {
         maxRetries = cint(maxRetries)
     }
 
-    //showLog
-    let showLog = get(opt, 'showLog')
-    if (!isbol(showLog)) {
-        showLog = true
+    //useShowLog
+    let useShowLog = get(opt, 'useShowLog')
+    if (!isbol(useShowLog)) {
+        useShowLog = true
     }
 
     //cfg
@@ -241,7 +241,7 @@ async function fetchMops(opt = {}) {
         maxRetries,
         baseDelayMs: DEFAULT_BASE_DELAY_MS,
         maxDelayMs: DEFAULT_MAX_DELAY_MS,
-        showLog,
+        useShowLog,
     }
 
     //targets
@@ -254,7 +254,7 @@ async function fetchMops(opt = {}) {
         }
     })
 
-    if (showLog) {
+    if (useShowLog) {
         console.log('啟動瀏覽器...')
     }
 
@@ -279,7 +279,7 @@ async function fetchMops(opt = {}) {
                 throw new Error(`瀏覽器啟動失敗（已重試 ${maxRetries} 次）: ${err.message}`)
             }
             let ms = Math.min(DEFAULT_BASE_DELAY_MS * attempt, DEFAULT_MAX_DELAY_MS)
-            if (showLog) {
+            if (useShowLog) {
                 console.warn(`[browser.launch][Retry ${attempt}/${maxRetries}] ${err.message} — 等待 ${ms / 1000}s 後重試...`)
             }
             await delay(ms)
@@ -291,7 +291,7 @@ async function fetchMops(opt = {}) {
         let page = await browser.newPage()
 
         //帶重試之頁面導航
-        if (showLog) {
+        if (useShowLog) {
             console.log('前往 MOPS 重大訊息頁面 (t146sb10)...')
         }
         for (let attempt = 1; attempt <= maxRetries + 1; attempt++) {
@@ -305,7 +305,7 @@ async function fetchMops(opt = {}) {
                     throw err
                 }
                 let ms = Math.min(DEFAULT_BASE_DELAY_MS * attempt, DEFAULT_MAX_DELAY_MS)
-                if (showLog) {
+                if (useShowLog) {
                     console.warn(`[page.goto][Retry ${attempt}/${maxRetries}] ${err.message} — 等待 ${ms / 1000}s 後重試...`)
                 }
                 await delay(ms)
@@ -318,7 +318,7 @@ async function fetchMops(opt = {}) {
         let results = []
         for (let target of targets) {
 
-            if (showLog) {
+            if (useShowLog) {
                 console.log(`正在抓取 [${target.name}] 資料...`)
             }
 
@@ -335,7 +335,7 @@ async function fetchMops(opt = {}) {
             await page.waitForTimeout(1000)
         }
 
-        if (showLog) {
+        if (useShowLog) {
             let summary = results.map((r) => {
                 let resultData = get(r, 'data.result', get(r, 'data'))
                 let count = Array.isArray(resultData) ? resultData.length : 0
@@ -372,7 +372,7 @@ export default fetchMops
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 19:16:45 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 Sep 13 2026 14:29:36 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/fetchRSS.mjs.html

@@ -145,7 +145,7 @@ async function getXml(rssUrl, method, cfg) {
  * @param {Integer} [opt.maxRetries=5] 輸入最大重試次數整數，含初始共執行maxRetries+1次，預設5
  * @param {Integer} [opt.baseDelayMs=3000] 輸入重試之線性退避基礎毫秒整數(僅fetch模式生效)，預設3000
  * @param {Integer} [opt.maxDelayMs=15000] 輸入重試之線性退避上限毫秒整數(僅fetch模式生效)，預設15000
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示重試訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示重試訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳項目物件陣列，各物件為{url,time,title,description,from}，withContent為true時另含content欄，網址無效或抓取失敗時reject回傳錯誤物件
  * @example
  *
@@ -245,7 +245,7 @@ export default fetchRSS
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 19:16:45 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 Sep 13 2026 14:29:36 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/fetchStatementdog.mjs.html

@@ -94,7 +94,7 @@ let FALLBACK_DATE = 'time, [class*="date"], [class*="time"]'
  * @param {Integer} [opt.maxRetries=10] 輸入最大重試次數整數，含初始共執行maxRetries+1次，預設10
  * @param {Integer} [opt.baseDelayMs=5000] 輸入重試之線性退避基礎毫秒整數，預設5000
  * @param {Integer} [opt.maxDelayMs=30000] 輸入重試之線性退避上限毫秒整數，預設30000
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳新聞物件陣列，各物件為{time,title,link}，抓取失敗或解析到0筆時reject回傳錯誤物件
  * @example
  *
@@ -123,9 +123,9 @@ async function fetchStatementdog(opt = {}) {
 
     //optFetch
     let optFetch = getOptFetch(opt, DFLT)
-    let showLog = optFetch.showLog
+    let useShowLog = optFetch.useShowLog
 
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Fetching ${url}...`)
     }
 
@@ -144,7 +144,7 @@ async function fetchStatementdog(opt = {}) {
     let titleSel = usePrimary ? PRIMARY_TITLE : FALLBACK_TITLE
     let linkSel = usePrimary ? PRIMARY_LINK : FALLBACK_LINK
     let dateSel = usePrimary ? PRIMARY_DATE : FALLBACK_DATE
-    if (!usePrimary && showLog) {
+    if (!usePrimary && useShowLog) {
         console.warn('主要 CSS selector 未匹配，嘗試 fallback selector...')
     }
 
@@ -172,7 +172,7 @@ async function fetchStatementdog(opt = {}) {
         newsItems.push({ time, title, link })
     })
 
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Extracted News Items: ${newsItems.length}`)
     }
 
@@ -200,7 +200,7 @@ export default fetchStatementdog
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 19:16:45 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 Sep 13 2026 14:29:36 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>

package/docs/fetchTaifex.mjs.html

@@ -191,7 +191,7 @@ function parseNum(str) {
 async function fetchFuturesData(dateSlash, cfg) {
 
     let url = `${cfg.baseUrl}/cht/3/futDataDown?down_type=1&queryStartDate=${dateSlash}&queryEndDate=${dateSlash}&commodity_id=TX`
-    if (cfg.showLog) {
+    if (cfg.useShowLog) {
         console.log(`Fetching futures data: ${url}`)
     }
 
@@ -248,7 +248,7 @@ async function fetchFuturesData(dateSlash, cfg) {
         result.afterHoursVolume = parseNum(afterHoursRow['成交量'])
     }
 
-    if (cfg.showLog) {
+    if (cfg.useShowLog) {
         console.log(`  台指期近月 (${nearMonth}): 開${result.open} 高${result.high} 低${result.low} 收${result.close} 結算${result.settlement} 量${result.volume}`)
         if (result.afterHoursClose !== null) {
             console.log(`  盤後: 收${result.afterHoursClose} 結算${result.afterHoursSettlement} 量${result.afterHoursVolume}`)
@@ -269,7 +269,7 @@ async function fetchFuturesData(dateSlash, cfg) {
 async function fetchInstitutionalData(dateSlash, cfg) {
 
     let url = `${cfg.baseUrl}/cht/3/futContractsDateDown?queryStartDate=${dateSlash}&queryEndDate=${dateSlash}&commodityId=TXF`
-    if (cfg.showLog) {
+    if (cfg.useShowLog) {
         console.log(`Fetching institutional data: ${url}`)
     }
 
@@ -300,7 +300,7 @@ async function fetchInstitutionalData(dateSlash, cfg) {
             tradingNet: parseNum(row['多空交易口數淨額']),
         }
 
-        if (cfg.showLog) {
+        if (cfg.useShowLog) {
             console.log(`  ${identity}: 未平倉淨額 ${result[key].netContracts} 口`)
         }
 
@@ -326,7 +326,7 @@ async function fetchInstitutionalData(dateSlash, cfg) {
 async function fetchPCRatio(dateSlash, cfg) {
 
     let url = `${cfg.baseUrl}/cht/3/pcRatioDown?queryStartDate=${dateSlash}&queryEndDate=${dateSlash}`
-    if (cfg.showLog) {
+    if (cfg.useShowLog) {
         console.log(`Fetching P/C ratio: ${url}`)
     }
 
@@ -346,7 +346,7 @@ async function fetchPCRatio(dateSlash, cfg) {
         openInterestRatio: parseNum(row['買賣權未平倉量比率%']),
     }
 
-    if (cfg.showLog) {
+    if (cfg.useShowLog) {
         console.log(`  Put ${result.putVolume} / Call ${result.callVolume} = ${result.ratio}%`)
     }
 
@@ -368,7 +368,7 @@ async function fetchPCRatio(dateSlash, cfg) {
  * @param {Integer} [opt.baseDelayMs=5000] 輸入重試之線性退避基礎毫秒整數，預設5000
  * @param {Integer} [opt.maxDelayMs=30000] 輸入重試之線性退避上限毫秒整數，預設30000
  * @param {Integer} [opt.interRequestDelayMs=1000] 輸入三支CSV之間隔毫秒整數，預設1000
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示過程訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示過程訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳結果物件{date,futures,institutional,pcRatio,errors}，日期無效或三支資料全失敗時reject回傳錯誤物件
  * @example
  *
@@ -406,8 +406,8 @@ async function fetchTaifex(dateStr, opt = {}) {
 
     //cfg
     let optFetch = getOptFetch(opt, DFLT)
-    let showLog = optFetch.showLog
-    let cfg = { baseUrl, showLog, optFetch }
+    let useShowLog = optFetch.useShowLog
+    let cfg = { baseUrl, useShowLog, optFetch }
 
     //interRequestDelayMs
     let interRequestDelayMs = get(opt, 'interRequestDelayMs')
@@ -420,7 +420,7 @@ async function fetchTaifex(dateStr, opt = {}) {
 
     //dateSlash
     let dateSlash = `${dateStr.substring(0, 4)}/${dateStr.substring(4, 6)}/${dateStr.substring(6, 8)}`
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Fetching TAIFEX data for ${dateStr} (${dateSlash})`)
     }
 
@@ -434,7 +434,7 @@ async function fetchTaifex(dateStr, opt = {}) {
     }
     catch (err) {
         let msg = `台指期行情: ${get(err, 'message', err)}`
-        if (showLog) {
+        if (useShowLog) {
             console.error(msg)
         }
         errors.push(msg)
@@ -447,7 +447,7 @@ async function fetchTaifex(dateStr, opt = {}) {
     }
     catch (err) {
         let msg = `三大法人: ${get(err, 'message', err)}`
-        if (showLog) {
+        if (useShowLog) {
             console.error(msg)
         }
         errors.push(msg)
@@ -460,7 +460,7 @@ async function fetchTaifex(dateStr, opt = {}) {
     }
     catch (err) {
         let msg = `Put/Call Ratio: ${get(err, 'message', err)}`
-        if (showLog) {
+        if (useShowLog) {
             console.error(msg)
         }
         errors.push(msg)
@@ -500,7 +500,7 @@ export default fetchTaifex
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 19:16:45 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 Sep 13 2026 14:29:36 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>