w-dwdata-hub 1.0.13 → 1.0.15

package/src/fetchTaifex.mjs

@@ -144,7 +144,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}`)
     }
 
@@ -201,7 +201,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}`)
@@ -222,7 +222,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}`)
     }
 
@@ -253,7 +253,7 @@ async function fetchInstitutionalData(dateSlash, cfg) {
             tradingNet: parseNum(row['多空交易口數淨額']),
         }
 
-        if (cfg.showLog) {
+        if (cfg.useShowLog) {
             console.log(`  ${identity}: 未平倉淨額 ${result[key].netContracts} 口`)
         }
 
@@ -279,7 +279,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}`)
     }
 
@@ -299,7 +299,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}%`)
     }
 
@@ -321,7 +321,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
  *
@@ -359,8 +359,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')
@@ -373,7 +373,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})`)
     }
 
@@ -387,7 +387,7 @@ async function fetchTaifex(dateStr, opt = {}) {
     }
     catch (err) {
         let msg = `台指期行情: ${get(err, 'message', err)}`
-        if (showLog) {
+        if (useShowLog) {
             console.error(msg)
         }
         errors.push(msg)
@@ -400,7 +400,7 @@ async function fetchTaifex(dateStr, opt = {}) {
     }
     catch (err) {
         let msg = `三大法人: ${get(err, 'message', err)}`
-        if (showLog) {
+        if (useShowLog) {
             console.error(msg)
         }
         errors.push(msg)
@@ -413,7 +413,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)

package/src/fetchTpex3insti.mjs

@@ -99,7 +99,7 @@ function assertTpexFieldShape(fields) {
  * @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回傳結果物件{source,date,data}，日期無效、無資料或欄位結構不符時reject回傳錯誤物件
  * @example
  *
@@ -138,7 +138,7 @@ async function fetchTpex3insti(dateStr, stockCodes, opt = {}) {
 
     //optFetch
     let optFetch = getOptFetch(opt, DFLT)
-    let showLog = optFetch.showLog
+    let useShowLog = optFetch.useShowLog
 
     //targetCodes
     let targetCodes = isearr(stockCodes) ? stockCodes : []
@@ -147,7 +147,7 @@ async function fetchTpex3insti(dateStr, stockCodes, opt = {}) {
     let rocDateStr = toRocDate(dateStr)
     let url = `${baseUrl}/web/stock/3insti/daily_trade/3itrade_hedge_result.php?l=zh-tw&t=D&d=${rocDateStr}&o=json`
 
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Fetching from: ${url}`)
         console.log(`Target: ${targetCodes.length === 0 ? 'All Market' : targetCodes.join(', ')}`)
     }
@@ -194,7 +194,7 @@ async function fetchTpex3insti(dateStr, stockCodes, opt = {}) {
         })
         .filter((item) => targetCodes.length === 0 || targetCodes.includes(item['代號']))
 
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Fetched ${processedData.length} records.`)
     }
 

package/src/fetchTpexMargin.mjs

@@ -37,7 +37,7 @@ let DFLT = {
  * @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回傳結果物件{source,date,count,data}，日期無效、無資料、欄位佈局不符或指定個股查無資料時reject回傳錯誤物件
  * @example
  *
@@ -75,7 +75,7 @@ async function fetchTpexMargin(dateStr, stockCodes, opt = {}) {
 
     //optFetch
     let optFetch = getOptFetch(opt, DFLT)
-    let showLog = optFetch.showLog
+    let useShowLog = optFetch.useShowLog
 
     //targetCodes
     let targetCodes = isearr(stockCodes) ? stockCodes.filter(Boolean) : []
@@ -84,7 +84,7 @@ async function fetchTpexMargin(dateStr, stockCodes, opt = {}) {
     let rocDate = toRocDate(dateStr)
     let url = `${baseUrl}/web/stock/margin_trading/margin_balance/margin_bal_result.php?l=zh-tw&d=${rocDate}&o=json`
 
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Fetching TPEX margin data: ${dateStr} (${rocDate})`)
         console.log(`Target: ${targetCodes.length > 0 ? targetCodes.join(', ') : 'All Market'}`)
         console.log(`URL: ${url}`)
@@ -160,7 +160,7 @@ async function fetchTpexMargin(dateStr, stockCodes, opt = {}) {
         }
     })
 
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Fetched ${parsedData.length} records.`)
     }
 

package/src/fetchTpexStock.mjs

@@ -40,7 +40,7 @@ let MIN_COLUMNS = 8
  * @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回傳結果物件{source,date,count,data}，日期無效、無資料或指定個股查無資料時reject回傳錯誤物件
  * @example
  *
@@ -75,7 +75,7 @@ async function fetchTpexStock(dateStr, stockCodes, opt = {}) {
 
     //optFetch
     let optFetch = getOptFetch(opt, DFLT)
-    let showLog = optFetch.showLog
+    let useShowLog = optFetch.useShowLog
 
     //targetCodes
     let targetCodes = isearr(stockCodes) ? stockCodes : []
@@ -84,7 +84,7 @@ async function fetchTpexStock(dateStr, stockCodes, opt = {}) {
     let rocDate = toRocDate(dateStr)
     let url = `${baseUrl}/web/stock/aftertrading/daily_close_quotes/stk_quote_result.php?l=zh-tw&d=${rocDate}&s=0,asc,0&o=json`
 
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Fetching TPEX data: ${dateStr} (${rocDate})`)
         console.log(`Target: ${targetCodes.length > 0 ? targetCodes.join(', ') : 'All Market'}`)
         console.log(`URL: ${url}`)

package/src/fetchTwDataHoliday.mjs

@@ -70,7 +70,7 @@ function isNonHolidayEntry(entry) {
  * @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回傳結果物件{dataYear,totalHolidays,holidays}，有給checkDate時另含{checkDate,isHoliday,holidayName}，API回傳非JSON或空陣列時reject回傳錯誤物件
  * @example
  *

package/src/fetchTwseMargin.mjs

@@ -39,7 +39,7 @@ let MIN_FIELDS = 16
  * @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回傳結果物件{source,date,count,data}，日期無效、API錯誤或指定個股查無資料時reject回傳錯誤物件
  * @example
  *
@@ -77,7 +77,7 @@ async function fetchTwseMargin(dateStr, stockCodes, opt = {}) {
 
     //optFetch
     let optFetch = getOptFetch(opt, DFLT)
-    let showLog = optFetch.showLog
+    let useShowLog = optFetch.useShowLog
 
     //targetCodes
     let targetCodes = isearr(stockCodes) ? stockCodes.filter(Boolean) : []
@@ -85,7 +85,7 @@ async function fetchTwseMargin(dateStr, stockCodes, opt = {}) {
     //url
     let url = `${baseUrl}/rwd/zh/marginTrading/MI_MARGN?date=${dateStr}&selectType=ALL&response=json`
 
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Fetching TWSE margin data: ${dateStr}`)
         console.log(`Target: ${targetCodes.length > 0 ? targetCodes.join(', ') : 'All Market'}`)
         console.log(`URL: ${url}`)
@@ -165,7 +165,7 @@ async function fetchTwseMargin(dateStr, stockCodes, opt = {}) {
         }
     })
 
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Fetched ${parsedData.length} records.`)
     }
 

package/src/fetchTwseStock.mjs

@@ -34,7 +34,7 @@ let DFLT = {
  * @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回傳證交所API原始資料物件，內含fields與data等欄位，日期無效、API回傳非OK或指定日無交易資料時reject回傳錯誤物件
  * @example
  *
@@ -69,7 +69,7 @@ async function fetchTwseStock(dateStr, stockCode, opt = {}) {
 
     //optFetch
     let optFetch = getOptFetch(opt, DFLT)
-    let showLog = optFetch.showLog
+    let useShowLog = optFetch.useShowLog
 
     //isSingleStock
     let isSingleStock = isestr(stockCode) && stockCode.toLowerCase() !== 'all'
@@ -84,7 +84,7 @@ async function fetchTwseStock(dateStr, stockCode, opt = {}) {
         url = `${baseUrl}/exchangeReport/MI_INDEX?response=json&date=${dateStr}&type=ALLBUT0999`
     }
 
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Fetching TWSE data: ${dateStr}, Stock: ${stockNo}`)
         console.log(`URL: ${url}`)
     }

package/src/fetchTwseT86.mjs

@@ -33,7 +33,7 @@ let DFLT = {
  * @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回傳結果物件{source,date,data}，日期無效或API錯誤時reject回傳錯誤物件
  * @example
  *
@@ -72,7 +72,7 @@ async function fetchTwseT86(dateStr, stockCodes, opt = {}) {
 
     //optFetch
     let optFetch = getOptFetch(opt, DFLT)
-    let showLog = optFetch.showLog
+    let useShowLog = optFetch.useShowLog
 
     //targetCodes
     let targetCodes = isearr(stockCodes) ? stockCodes : []
@@ -80,7 +80,7 @@ async function fetchTwseT86(dateStr, stockCodes, opt = {}) {
     //url
     let url = `${baseUrl}/rwd/zh/fund/T86?response=json&date=${dateStr}&selectType=ALL`
 
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Fetching from: ${url}`)
         console.log(`Target: ${targetCodes.length === 0 ? 'All Market' : targetCodes.join(', ')}`)
     }
@@ -125,7 +125,7 @@ async function fetchTwseT86(dateStr, stockCodes, opt = {}) {
         parsedData = parsedData.filter((item) => targetCodes.includes(item[codeField]))
     }
 
-    if (showLog) {
+    if (useShowLog) {
         console.log(`Fetched ${parsedData.length} records.`)
     }
 

package/src/fetchWithRetry.mjs

@@ -154,7 +154,7 @@ async function fetchOnce(url, cfg) {
  * @param {Integer} [opt.maxDelayMs=30000] 輸入線性退避之上限毫秒整數，預設30000
  * @param {Array} [opt.retryStatus=[]] 輸入額外視為可重試之HTTP狀態碼陣列，例如[403]，預設[]
  * @param {String} [opt.label=''] 輸入重試訊息前綴字串，預設''
- * @param {Boolean} [opt.showLog=true] 輸入是否顯示重試訊息布林值，預設true
+ * @param {Boolean} [opt.useShowLog=true] 輸入是否顯示重試訊息布林值，預設true
  * @returns {Promise} 回傳Promise，resolve回傳解析後資料，responseType為'json'時回物件、'text'時回字串、'arrayBuffer'時回ArrayBuffer，重試耗盡或遇不可重試錯誤時reject回傳錯誤物件
  * @example
  *
@@ -261,10 +261,10 @@ async function fetchWithRetry(url, opt = {}) {
         label = 'fetchWithRetry'
     }
 
-    //showLog
-    let showLog = get(opt, 'showLog')
-    if (!isbol(showLog)) {
-        showLog = true
+    //useShowLog
+    let useShowLog = get(opt, 'useShowLog')
+    if (!isbol(useShowLog)) {
+        useShowLog = true
     }
 
     //cfg
@@ -287,7 +287,7 @@ async function fetchWithRetry(url, opt = {}) {
 
             //線性退避
             let ms = Math.min(baseDelayMs * attempt, maxDelayMs)
-            if (showLog) {
+            if (useShowLog) {
                 console.warn(`[${label}][Retry ${attempt}/${maxRetries}] ${err.message} — 等待 ${ms / 1000}s 後重試...`)
             }
             await delay(ms)

package/src/getOptFetch.mjs

@@ -55,7 +55,7 @@ function pickPint(opt, dflt, key, fallback) {
  * import getOptFetch from './src/getOptFetch.mjs'
  *
  * console.log(getOptFetch({ maxRetries: 2 }, { timeout: 15000, label: 'abc' }))
- * // => { timeout: 15000, maxRetries: 2, baseDelayMs: 5000, maxDelayMs: 30000, showLog: true, label: 'abc' }
+ * // => { timeout: 15000, maxRetries: 2, baseDelayMs: 5000, maxDelayMs: 30000, useShowLog: true, label: 'abc' }
  *
  */
 function getOptFetch(opt = {}, dflt = {}) {
@@ -72,13 +72,13 @@ function getOptFetch(opt = {}, dflt = {}) {
         maxRetries = cint(maxRetries)
     }
 
-    //showLog
-    let showLog = get(opt, 'showLog')
-    if (!isbol(showLog)) {
-        showLog = get(dflt, 'showLog')
+    //useShowLog
+    let useShowLog = get(opt, 'useShowLog')
+    if (!isbol(useShowLog)) {
+        useShowLog = get(dflt, 'useShowLog')
     }
-    if (!isbol(showLog)) {
-        showLog = true
+    if (!isbol(useShowLog)) {
+        useShowLog = true
     }
 
     let r = {
@@ -86,7 +86,7 @@ function getOptFetch(opt = {}, dflt = {}) {
         maxRetries,
         baseDelayMs: pickPint(opt, dflt, 'baseDelayMs', DEFAULT_BASE_DELAY_MS),
         maxDelayMs: pickPint(opt, dflt, 'maxDelayMs', DEFAULT_MAX_DELAY_MS),
-        showLog,
+        useShowLog,
     }
 
     //各函數固有特性, 不開放呼叫端覆寫

package/test/fetchAiNewsAggregator.test.mjs

@@ -18,7 +18,7 @@ describe('fetchAiNewsAggregator', function() {
     })
 
     it('轉為統一格式並去除欄位前後空白', async function() {
-        let r = await fetchAiNewsAggregator({ url: svr.url('/ai-news/latest-24h.json'), showLog: false })
+        let r = await fetchAiNewsAggregator({ url: svr.url('/ai-news/latest-24h.json'), useShowLog: false })
         let rr = [
             {
                 url: 'https://ai.example/a1',
@@ -39,7 +39,7 @@ describe('fetchAiNewsAggregator', function() {
     })
 
     it('published_at無法解析時time退回空字串', async function() {
-        let t = await fetchAiNewsAggregator({ url: svr.url('/ai-news/latest-24h.json'), showLog: false })
+        let t = await fetchAiNewsAggregator({ url: svr.url('/ai-news/latest-24h.json'), useShowLog: false })
         let r = t[1].time
         let rr = ''
         assert.strict.deepEqual(r, rr)
@@ -47,7 +47,7 @@ describe('fetchAiNewsAggregator', function() {
 
     it('回傳非JSON時reject', async function() {
         let r = null
-        await fetchAiNewsAggregator({ url: svr.url('/json/bad'), maxRetries: 0, showLog: false })
+        await fetchAiNewsAggregator({ url: svr.url('/json/bad'), maxRetries: 0, useShowLog: false })
             .then(() => {
                 r = 'resolved'
             })
@@ -61,7 +61,7 @@ describe('fetchAiNewsAggregator', function() {
     it('HTTP 404不重試並reject', async function() {
         let c0 = svr.getCount('/status/404')
         let e = null
-        await fetchAiNewsAggregator({ url: svr.url('/status/404'), maxRetries: 3, showLog: false })
+        await fetchAiNewsAggregator({ url: svr.url('/status/404'), maxRetries: 3, useShowLog: false })
             .catch((err) => {
                 e = err
             })
@@ -71,7 +71,7 @@ describe('fetchAiNewsAggregator', function() {
     })
 
     it('回應無items欄位時回傳空陣列', async function() {
-        let r = await fetchAiNewsAggregator({ url: svr.url('/json/ok'), showLog: false })
+        let r = await fetchAiNewsAggregator({ url: svr.url('/json/ok'), useShowLog: false })
         let rr = []
         assert.strict.deepEqual(r, rr)
     })

package/test/fetchAisixiang.test.mjs

@@ -22,7 +22,7 @@ describe('fetchAisixiang', function() {
 
     before(async function() {
         svr = await serverForTest()
-        optFast = { baseUrl: svr.url(''), baseDelayMs: 10, maxDelayMs: 10, pageDelayMs: 0, showLog: false }
+        optFast = { baseUrl: svr.url(''), baseDelayMs: 10, maxDelayMs: 10, pageDelayMs: 0, useShowLog: false }
     })
 
     after(async function() {

package/test/fetchCnyes.test.mjs

@@ -18,7 +18,7 @@ describe('fetchCnyes', function() {
     })
 
     it('轉為統一格式並組出新聞內容頁網址', async function() {
-        let r = await fetchCnyes({ url: svr.url('/cnyes/newslist'), pageDelayMs: 0, showLog: false })
+        let r = await fetchCnyes({ url: svr.url('/cnyes/newslist'), pageDelayMs: 0, useShowLog: false })
         let rr = [
             { time: '2026-08-06 15:06:40', title: '鉅亨標題一', link: 'https://news.cnyes.com/news/id/5001' },
             { time: '', title: '鉅亨標題二', link: 'https://news.cnyes.com/news/id/5002' },
@@ -27,7 +27,7 @@ describe('fetchCnyes', function() {
     })
 
     it('publishAt缺漏時該筆time退回空字串, 不影響其餘新聞', async function() {
-        let t = await fetchCnyes({ url: svr.url('/cnyes/newslist'), pageDelayMs: 0, showLog: false })
+        let t = await fetchCnyes({ url: svr.url('/cnyes/newslist'), pageDelayMs: 0, useShowLog: false })
         let r = [t.length, t[1].time, t[1].title]
         let rr = [2, '', '鉅亨標題二']
         assert.strict.deepEqual(r, rr)
@@ -35,7 +35,7 @@ describe('fetchCnyes', function() {
 
     it('無更多資料時停止翻頁', async function() {
         let c0 = svr.getCount('/cnyes/newslist')
-        await fetchCnyes({ url: svr.url('/cnyes/newslist'), pageDelayMs: 0, showLog: false })
+        await fetchCnyes({ url: svr.url('/cnyes/newslist'), pageDelayMs: 0, useShowLog: false })
         let r = svr.getCount('/cnyes/newslist') - c0
         let rr = 2
         assert.strict.deepEqual(r, rr)
@@ -43,7 +43,7 @@ describe('fetchCnyes', function() {
 
     it('targetTotal達標即停止翻頁', async function() {
         let c0 = svr.getCount('/cnyes/newslist')
-        let t = await fetchCnyes({ url: svr.url('/cnyes/newslist'), targetTotal: 1, pageDelayMs: 0, showLog: false })
+        let t = await fetchCnyes({ url: svr.url('/cnyes/newslist'), targetTotal: 1, pageDelayMs: 0, useShowLog: false })
         let r = [t.length, svr.getCount('/cnyes/newslist') - c0]
         let rr = [1, 1]
         assert.strict.deepEqual(r, rr)
@@ -51,7 +51,7 @@ describe('fetchCnyes', function() {
 
     it('HTTP 403納入重試範圍, 含初始共執行maxRetries+1次', async function() {
         let c0 = svr.getCount('/status/403')
-        await fetchCnyes({ url: svr.url('/status/403'), maxRetries: 2, baseDelayMs: 10, maxDelayMs: 10, pageDelayMs: 0, showLog: false })
+        await fetchCnyes({ url: svr.url('/status/403'), maxRetries: 2, baseDelayMs: 10, maxDelayMs: 10, pageDelayMs: 0, useShowLog: false })
             .catch(() => {})
         let r = svr.getCount('/status/403') - c0
         let rr = 3

package/test/fetchGuancha.test.mjs

@@ -24,7 +24,7 @@ describe('fetchGuancha', function() {
 
     before(async function() {
         svr = await serverForTest()
-        optFast = { baseUrl: svr.url(''), maxRetries: 0, pageDelayMs: 0, showLog: false }
+        optFast = { baseUrl: svr.url(''), maxRetries: 0, pageDelayMs: 0, useShowLog: false }
     })
 
     after(async function() {

package/test/fetchHackerNews.test.mjs

@@ -18,7 +18,7 @@ describe('fetchHackerNews', function() {
     })
 
     it('僅保留story, 無url者退回站內討論頁網址', async function() {
-        let r = await fetchHackerNews(30, { apiBase: svr.url('/hn'), showLog: false })
+        let r = await fetchHackerNews(30, { apiBase: svr.url('/hn'), useShowLog: false })
         let rr = [
             {
                 url: 'https://hn.example/1',
@@ -39,7 +39,7 @@ describe('fetchHackerNews', function() {
     })
 
     it('limit限制取回篇數', async function() {
-        let t = await fetchHackerNews(1, { apiBase: svr.url('/hn'), showLog: false })
+        let t = await fetchHackerNews(1, { apiBase: svr.url('/hn'), useShowLog: false })
         let r = [t.length, t[0].title]
         let rr = [1, 'HN標題一']
         assert.strict.deepEqual(r, rr)
@@ -48,7 +48,7 @@ describe('fetchHackerNews', function() {
     it('limit非正整數時改用預設值30而非回傳空陣列', async function() {
         let r = []
         for (let limit of [0, -1, NaN, null, undefined, 'abc']) {
-            let t = await fetchHackerNews(limit, { apiBase: svr.url('/hn'), showLog: false })
+            let t = await fetchHackerNews(limit, { apiBase: svr.url('/hn'), useShowLog: false })
             r.push(t.length)
         }
         let rr = [2, 2, 2, 2, 2, 2]
@@ -56,7 +56,7 @@ describe('fetchHackerNews', function() {
     })
 
     it('apiBase尾端斜線會被正規化', async function() {
-        let t = await fetchHackerNews(30, { apiBase: svr.url('/hn') + '/', showLog: false })
+        let t = await fetchHackerNews(30, { apiBase: svr.url('/hn') + '/', useShowLog: false })
         let r = t.length
         let rr = 2
         assert.strict.deepEqual(r, rr)
@@ -64,7 +64,7 @@ describe('fetchHackerNews', function() {
 
     it('取ID清單失敗時reject', async function() {
         let r = null
-        await fetchHackerNews(30, { apiBase: svr.url('/nothing'), maxRetries: 0, showLog: false })
+        await fetchHackerNews(30, { apiBase: svr.url('/nothing'), maxRetries: 0, useShowLog: false })
             .then(() => {
                 r = 'resolved'
             })

package/test/fetchMoneydj.test.mjs

@@ -8,7 +8,7 @@ describe('fetchMoneydj', function() {
     let svr = null
 
     //optFast, 令重試與頁間等待縮至最短, 避免測試耗時
-    let optFast = { baseDelayMs: 10, maxDelayMs: 10, pageDelayMs: 0, showLog: false }
+    let optFast = { baseDelayMs: 10, maxDelayMs: 10, pageDelayMs: 0, useShowLog: false }
 
     before(async function() {
         svr = await serverForTest()

package/test/fetchMops.test.mjs

@@ -62,7 +62,7 @@ describe('fetchMops', function() {
             pageUrl: svr.url('/mops/page'),
             apiUrl: svr.url('/mops/api/t146sb10'),
             maxRetries: 0,
-            showLog: false,
+            useShowLog: false,
         })
         let r = [
             t.hasError,
@@ -92,7 +92,7 @@ describe('fetchMops', function() {
             pageUrl: svr.url('/mops/page'),
             apiUrl: svr.url('/mops-error/api/t146sb10'),
             maxRetries: 0,
-            showLog: false,
+            useShowLog: false,
         })
         let r = [
             t.hasError,