Node.js v22.14.0 JodLTS發(fā)布全解讀TypeScript 執(zhí)行增強、process.ref/unref 與 test_runner 快照新 API【免費下載鏈接】nodejs.orgThe Node.js? Website項目地址: https://gitcode.com/GitHub_Trending/no/nodejs.org本篇基于 nodejs.org 倉庫中的官方發(fā)布博文 v22.14.0 發(fā)布說明 展開系統(tǒng)解讀 2025 年 2 月 11 日發(fā)布的 Node.js v22.14.0 JodLTS版本13 項 Notable Changes、近百條提交的模塊級梳理、全平臺安裝包與 SHASUMS 校驗方式并順帶揭示這份發(fā)布博文在 nodejs.org 倉庫中是如何被自動化生成與展示的。讀完本文你可以快速評估該版本是否值得升級以及如何安全下載、校驗并應用這一 LTS 版本。一、版本概況Active LTS 窗口內(nèi)的重要增量發(fā)布項目值版本號22.14.0代號Jod發(fā)布類型LTS長期支持發(fā)布日期2025-02-11發(fā)布負責人aduh95Antoine du Hamel變更性質(zhì)全部為增量增強無破壞性變更標記v22 主線處于 Active LTS 階段。本倉庫的發(fā)布數(shù)據(jù)生成器 releaseData.mjs 給出了官網(wǎng)判斷版本狀態(tài)的統(tǒng)一邏輯若已過 EOL 日期則標記為EOL若該主版本最新版處于 LTS 階段則標記為LTS否則為Current。22.14.0 作為 Jod 的 LTS 增量版本延續(xù)了「以功能增強與穩(wěn)定性修復為主」的節(jié)奏——本版 13 項 Notable Changes 中有 12 項帶有(SEMVER-MINOR)標記即向后兼容的小版本特性新增。二、Notable Changes13 項核心變更逐項解析2.1 TypeScript 支持再進一步lib / module / worker / deps本版本在 TypeScript 原生執(zhí)行type stripping方向上連續(xù)落地了多項能力提交均由 Marco Ippolito 主導STDIN 求值支持 TypeScriptlib#56359此前node -e、STDIN 管道等求值入口無法直接處理帶類型注解的代碼本版起可以直接傳入包含 TypeScript 語法的輸入由內(nèi)置的 amaroSWC 的 Rust 綁定剝離類型后執(zhí)行例如echo const greeting: string Hello Jod; console.log(greeting); | node --input-typemodule-typescript -新增錯誤碼ERR_UNSUPPORTED_TYPESCRIPT_SYNTAXmodule#56610當模塊加載流程遇到無法剝離的 TypeScript 語法如 enum、namespace 等 amaro 暫不支持的類型級語法時拋出語義明確的專用錯誤碼便于開發(fā)者快速定位哪些 TS 語法需要改寫。Worker 支持 eval TS 輸入worker#56394new Worker()的 eval 模式同樣獲得類型剝離能力與主線程的-e/STDIN 行為對齊。module統(tǒng)一 CommonJS 中 TypeScript 與.mjs的處理#55590重構了 CJS 加載器對 TS 文件的判斷與解析路徑使其與 ESM 側行為保持一致。與之配套本版將 amaro 依賴從 0.2.1 一路升級到 0.3.0#56568、#56390并專門為module增加了對 SWC 錯誤的防御式處理#56646與 amaro 錯誤信息的重新拋出#56568避免底層錯誤被吞掉或誤報。測試側新增了 ts eval 快照用例#56358并在 Windows ARM64 上啟用了相關測試#56349。注意具體命令行入口與標志如--input-type的取值、是否需要--experimental-strip-types隨版本演進有差異請以當前安裝版本的node --help輸出與對應版本文檔為準。2.2fs.glob的exclude選項支持 glob 模式從 v22.14.0 起node:fs的 glob 相關 APIfs.glob、fs/promises.glob的exclude選項不再局限于字面路徑而是可以接受 glob 模式#56489。這意味著可以更自然地寫出排除規(guī)則import { glob } from node:fs/promises; // 排除所有 .test.js 文件與 node_modules 目錄 for await (const file of glob(**/*.js, { exclude: [**/*.test.js, **/node_modules/**], })) { console.log(file); }對于需要在大目錄樹中做文件遍歷的工具腳本這一改動顯著降低了編寫排除規(guī)則的復雜度。2.3module.findPackageJSON工具node:module新增了同步工具findPackageJSON#55412用于從給定路徑向上查找最近的package.json并返回其路徑無需再手寫逐級path.resolve(dir, package.json)的循環(huán)import { findPackageJSON } from node:module; const pkgPath findPackageJSON(/some/project/src/index.js); console.log(pkgPath); // /some/project/package.json該實現(xiàn)隨后經(jīng)歷了簡化重構#55543與異步解析錯誤修復#56382保證同步接口在內(nèi)部解析出錯時能正確失敗而不產(chǎn)生懸掛的異步回調(diào)。2.4process.ref()與process.unref()process新增了ref()/unref()兩個方法#56400用于顯式控制進程是否因某個活動句柄而保持存活。典型場景是 Child Process 的 stdio 句柄child.unref()后父進程可以先行退出需要時再child.ref()恢復關聯(lián)const { spawn } require(node:child_process); const child spawn(node, [-e, setInterval(() {}, 1000)]); child.unref(); // 父進程不再等待該子進程 // ... 某些條件下希望重新等待 child.ref();本版同時在 process 相關提交 中修正了方法符號鍵、并將其標記為實驗性experimental#56517使用前應關注實驗性 API 的語義變動風險。2.5node:sqlite的StatementSync支持 TypedArray 與 DataViewnode:sqlite的StatementSync在綁定參數(shù)時新增了對TypedArray與DataView的支持#56385可以直接將二進制緩沖區(qū)寫入 SQLite 的 BLOB 列import { DatabaseSync } from node:sqlite; const db new DatabaseSync(:memory:); db.exec(CREATE TABLE blobs (id INTEGER PRIMARY KEY, data BLOB)); const stmt db.prepare(INSERT INTO blobs (data) VALUES (?)); stmt.run(new Uint8Array([1, 2, 3, 4])); // TypedArray 直接綁定這對于需要持久化圖片、序列化數(shù)據(jù)等二進制內(nèi)容的 SQLite 應用是一處實用性較強的補全。具體參數(shù)綁定語義以 node:sqlite 官方文檔 為準。2.6 運行時與 Worker--disable-sigusr1與isInternalWorker--disable-sigusr1src#56441新增啟動標志用于禁用 SIGUSR1 信號 I/O 線程。在部分容器化或特殊信號策略的 Linux 環(huán)境下SIGUSR1 信號線程可能帶來干擾該標志為這類運維場景提供了顯式開關。isInternalWorkersrc,worker#56469Worker 模塊暴露內(nèi)部 Worker 標識能力便于區(qū)分框架/運行時內(nèi)部創(chuàng)建的 Worker與用戶業(yè)務 Worker。本版文檔還特別補充了該特性與 Permission Model權限模型 配合使用的說明#56706——在啟用--permission的場景下內(nèi)部 Worker 的權限判定與普通 Worker 存在差異。2.7test_runnerwaitFor / fileSnapshot / assert.register內(nèi)置測試運行器node:test一口氣新增了三項 API均出自 Colin IhrigTestContext.prototype.waitFor()#56595允許測試體等待任意 Promise 完成而不必將該 Promise 作為返回值交給框架適合測試過程中啟動的后臺任務場景import test from node:test; test(等待后臺異步任務, async (t) { const task startBackgroundJob(); await t.waitFor(task); // 任務完成后繼續(xù)斷言 });t.assert.fileSnapshot()#56459對文件內(nèi)容做快照斷言首次運行生成快照后續(xù)運行對比文件內(nèi)容是否與快照一致配合本版將快照測試整體標記為穩(wěn)定#56425使用import test from node:test; test(生成物快照, (t) { writeFileSync(out.json, JSON.stringify(generate(), null, 2)); t.assert.fileSnapshot(out.json); // 與 .snap 快照對比 });assert.register()#56434向t.assert注冊自定義斷言函數(shù)讓業(yè)務斷言可以被復用并納入統(tǒng)一的斷言體系。另外spec報告器修復了失敗斷言重復打印的問題#56662并新增了僅輸出錯誤的 reporter 測試#56438。2.8 信任鏈刷新NSS 3.107 根證書更新crypto模塊將內(nèi)置的 TLS 根證書集更新至 NSS 3.107#56566。這意味著使用 Node.js 內(nèi)置證書庫發(fā)起 HTTPS 請求時CA 信任列表與 Mozilla NSS 保持同步新增/吊銷的根證書隨之生效。對于依賴內(nèi)置信任庫的客戶端應用這是一次常規(guī)但重要的安全同步。三、Commits 提交亮點按模塊梳理除去 Notable Changes本版還有近百條提交按模塊歸類如下。3.1 assert 與 utilassert的myers_diff函數(shù)性能優(yōu)化#56303partialDeepStrictEqual支持 URL 與File原型對象#56231部分比較失敗時展示 diff#56211并能正確拋出0與-0的比較差異#56237。util.inspect修復了三類崩潰Error 的 stack 中包含 Symbol#56573、Error 的name是正則對象#56574、函數(shù)名為 Symbol#56572。util的 CallSite 暴露scriptId#56551并將CallSite.column重命名為columnNumber#56584。3.2 crypto修復checkPrime在超大緩沖區(qū)下的崩潰#56559generatePrime/checkPrime改為可中斷interruptible操作#56460長耗時素數(shù)運算不再阻塞事件循環(huán)補齊多處的返回值檢查#56615、#56527。3.3 依賴與構建corepack 升級至 0.31.0#56795ngtcp2 升級至 1.10.0#56334simdutf 多次升級#56567、#56388、#56332googletest 更新#56387、#56370inspector_protocol移入 deps 目錄#56649。構建側macOS 上為 V8 啟用-fvisibilityhidden#56275修復 GCC 15 構建#56740與 loong64 構建#56466。3.4 inspector / diagnostics_channel / http2inspector 增加 undici HTTP 請求追蹤支持#56488并修復loadingFinished在響應體被消費前就上報的問題#56372調(diào)試網(wǎng)絡請求的時序更準確。diagnostics_channel開始捕獲 console 消息#56292訂閱者可觀測應用內(nèi)的 console 輸出。http2在連接主機為 IP 地址時不再發(fā)送 server name#56530避免 SNI 語義錯誤。3.5 sqlite 其他改進啟用 SQL 數(shù)學函數(shù)#56447沖突解決處理器現(xiàn)在能拿到?jīng)_突類型#56352構建期禁用 memstatus API#56541編譯型測試與非編譯型測試對齊#56446。3.6 stream / tls / url / watch / workerstream修復ReadableStreamBYOBReader.readIntoRequests的拼寫錯誤#56560校驗WritableStream中未定義的sizeAlgorithm#56067。tls修復cryptoErrorListToException()的棧轉換問題#56554。url使用解析后的路徑將 UNC 路徑轉換為 URL#56302。watch--env-file-if-exists場景下支持環(huán)境文件變更后重載#56643。worker重構 stdio 以提升性能#56630并在退出時刷新 stdout/stderr#56428避免日志丟失。libFORCE_COLOR在非 TTY 環(huán)境也強制輸出顏色#55404優(yōu)化內(nèi)置棧幀的prepareStackTrace并抑制 source map 查找異常#56299允許跳過node_modules中的 source map 查找#56639。punycode棄用警告限流避免在大量使用該模塊的應用中出現(xiàn)刷屏#56632。3.7 權限模型與文檔權限模型Permission Model相關--permission取代實驗性前綴--experimental-permission的測試遷移#56685、重復路徑授予的去重#56591、fork 繼承權限標志的澄清#56523以及新增使用 npx 配合權限模型的文檔章節(jié)#56539。文檔工作還包括Skip to content無障礙按鈕#56750、可折疊列表的無障礙改進#56749等若干體驗類更新。四、下載與校驗從發(fā)布博文到安裝包發(fā)布博文的末尾會固定列出該版本全部發(fā)行物由生成腳本的downloadsTable模塊產(chǎn)出見 downloadsTable.mjsv22.14.0 的安裝包清單如下平臺架構安裝包 / 二進制Windowsx86 / x64 / ARM64.msi安裝器與node.exe二進制macOSIntel / Apple Silicon.pkg安裝器與darwin-x64/darwin-arm64tar 包Linuxx64 / arm64 / armv7l / ppc64le / s390x.tar.xz與.tar.gzAIXppc64.tar.gz其他—源碼包node-v22.14.0.tar.gz、-headers頭文件包、-win-*.7z/zip壓縮包以上文件統(tǒng)一發(fā)布在官方發(fā)行目錄nodejs.org/dist/v22.14.0/下版本對應 API 文檔位于nodejs.org/docs/v22.14.0/api/。如需完整列表可直接查看發(fā)布博文原文的下載段落v22.14.0.md。4.1 SHASUMS 與 PGP 校驗流程博文末尾附帶了SHASUMS256.txt.asc的完整內(nèi)容一段PGP 簽名消息內(nèi)含每個發(fā)行物文件名的 SHA-256 哈希。以幾個條目為例ddec69aded8f826efbef8b4af09baa451f5ed8b057e84d836accf33de04d2d7a node-v22.14.0-aix-ppc64.tar.gz e9404633bc02a5162c5c573b1e2490f5fb44648345d64a958b17e325729a5e42 node-v22.14.0-darwin-arm64.tar.gz 9d942932535988091034dc94cc5f42b6dc8784d6366df3a36c4c9ccb3996f0c2 node-v22.14.0-linux-x64.tar.gz推薦的校驗流程為先驗證SHASUMS256.txt.asc的 PGP 簽名確認哈希清單本身未被篡改再用shasum -a 256 -c對比本地下載文件的哈希。Node.js 官網(wǎng)下載頁current.mdx也提供了指向如何校驗已簽名 SHASUMS的指引入口并將其作為下載流程的安全建議步驟。五、在 nodejs.org 倉庫中發(fā)布博文如何生成與展示這份發(fā)布說明并非純手工撰寫其生成鏈路在本倉庫中清晰可見。5.1 生成腳本與模板apps/site/scripts/release-post/index.mjs 是發(fā)布博文的自動化生成器通過fetchChangelog從上游 changelog 抓取對應版本章節(jié)、fetchAuthor解析發(fā)布負責人、fetchVersionPolicy提取 LTS/Stable 狀態(tài)、fetchShasums拉取 PGP 簽名的哈希清單并用verifyDownloads逐個 HEAD 探測安裝包是否已就緒。運行方式為node index.mjs [version]若省略版本號腳本會自動從發(fā)行索引中選取最新版本。生成結果經(jīng)由 template.hbs 模板渲染frontmatter changelog 下載鏈接 SHASUMS 塊再通過 Prettier 格式化后寫入pages/en/blog/release/v{version}.md——這正是本文所依據(jù)的 v22.14.0.md 的來源。5.2 官網(wǎng)側的消費與展示發(fā)布博文發(fā)布后會被 blog-data 生成器 匯總進博客數(shù)據(jù)供 博客歸檔頁 使用。下載頁 current.mdx 通過Release.Provider、Release.VersionDropdown、Release.PrebuiltDownloadButtons等組件動態(tài)渲染當前版本的安裝方式并提供ChangelogLink/BlogPostLink直達本博文。各主版本的 LTS/Current/EOL 狀態(tài)則由 releaseData.mjs 統(tǒng)一計算對應測試見 releaseData.test.mjs。六、升級評估與注意事項綜合本版變更給出以下升級評估建議風險很低13 項 Notable Changes 均為SEMVER-MINOR增量特性根證書更新為常規(guī)安全同步發(fā)布負責人未標注任何破壞性變更v22 用戶可放心升級。TypeScript 用戶值得關注STDIN / eval / Worker 的 TS 支持與ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX錯誤碼讓免編譯跑 TS的體驗更完整但 amaro 仍只支持類型剝離遇到 enum、namespace 等語法會報ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX需要改寫為可剝離語法。測試基建增強t.assert.fileSnapshot()、waitFor()、assert.register()三項新 API 加上快照測試轉正適合在 CI 中逐步采用。實驗性 API 需謹慎process.ref()/process.unref()已明確標記為 experimental生產(chǎn)環(huán)境使用前請評估其后續(xù)可能的變化。安全與運維建議升級后復核依賴內(nèi)置根證書的 HTTPS 客戶端行為特殊信號環(huán)境可評估--disable-sigusr1。安裝或升級時優(yōu)先從官方發(fā)行目錄獲取對應平臺安裝包并通過 PGP 簽名與 SHA-256 雙重校驗確保完整性。【免費下載鏈接】nodejs.orgThe Node.js? Website項目地址: https://gitcode.com/GitHub_Trending/no/nodejs.org創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考