docs(release-cleanup): 校正 JSDoc 例外說明、刷新指令檔更新時間並重建 README

This commit is contained in:
Jeffery
2026-07-01 09:28:03 +08:00
parent 0ab90be3bb
commit a4fa7fec85
6 changed files with 33 additions and 25 deletions
+4 -1
View File
@@ -196,7 +196,9 @@ async function main() {
* @async
* @param {string} baseUrl 不含分頁參數的 API 端點(例如 .../releases 或 .../tags)。
* @returns {Promise<Array<object>>} 所有頁面項目合併後的陣列。
* @throws 不擲出例外;HTTP 失敗時直接呼叫 process.exit(1) 結束程序
* @throws HTTP 非 2xx 時不擲例外,直接呼叫 process.exit(1) 結束程序
* 但底層 fetch 網路錯誤或回應非 JSON 造成的 res.json() 解析失敗仍會上拋,
* 最終由檔尾 main().catch 統一捕捉後 process.exit(1)。
*/
async function fetchAllPages(baseUrl) {
const all = [];
@@ -228,6 +230,7 @@ async function main() {
* @async
* @param {string} url 要刪除之資源的完整 URLrelease 或 tag 端點)。
* @returns {Promise<number>} 回應的 HTTP 狀態碼。
* @throws 不主動擲例外;但底層 fetch 網路錯誤會上拋,由 main().catch 統一捕捉後 process.exit(1)。
*/
async function deleteUrl(url) {
const res = await fetch(url, { method: 'DELETE', headers: authHeaders });