戰(zhàn)指南：深入 parseHeaders 與 headerNameToString)
后端網(wǎng)絡(luò)通信【免費(fèi)下載鏈接】undiciAn HTTP/1.1 client, written from scratch for Node.js項(xiàng)目地址https://gitcode.com/gh_mirrors/un/undici點(diǎn)擊查看免費(fèi)下載本文以 undiciNode.js 從零實(shí)現(xiàn)的 HTTP/1.1 客戶端暴露的util工具集為主線完整講解parseHeaders與headerNameToString兩個(gè)核心工具的用法、底層實(shí)現(xiàn)與內(nèi)部調(diào)用場(chǎng)景。讀完本文你將能夠在自定義Dispatcher/ Handler 實(shí)現(xiàn)中以與 undici 完全一致的方式完成 header 名歸一化與扁平原始 header 列表解析并理解其背后的性能設(shè)計(jì)常見(jiàn) header 名查表 三叉搜索樹(shù)與編碼細(xì)節(jié)latin1 解碼。一、util工具集是什么為什么需要它undici 的util是一小組面向第三方Dispatcher實(shí)現(xiàn)的工具函數(shù)lib/core/util.js 中實(shí)現(xiàn)從 v1.2.0 起對(duì)外暴露當(dāng)前穩(wěn)定性等級(jí)為Stable2。它覆蓋了 undici 內(nèi)部使用的 header 處理原語(yǔ)目的是讓自定義 dispatcher 和 handler 能“與 undici 完全一致地”規(guī)范化 header 名稱、解析原始 header 列表——例如Set-Cookie這類可重復(fù) header 的合并行為以及大小寫歸一化規(guī)則。在 index.js 中對(duì)外導(dǎo)出的util對(duì)象只暴露了兩個(gè)函數(shù)module.exports.util { parseHeaders: util.parseHeaders, headerNameToString: util.headerNameToString }也就是說(shuō)從包外部你能拿到的就是這兩個(gè) API。引入方式如下// ESM import { util } from undici const { parseHeaders, headerNameToString } util// CommonJS const { util } require(undici) const { parseHeaders, headerNameToString } util同時(shí) types/util.d.ts 提供了完整的 TypeScript 類型聲明函數(shù)簽名如下export function headerNameToString (value: string | Buffer): string export function parseHeaders ( headers: (Buffer | string | (Buffer | string)[])[], obj?: Recordstring, string | string[] ): Recordstring, string | string[]二、parseHeaders(headers[, obj])扁平 header 列表 → 規(guī)范對(duì)象2.1 參數(shù)與返回值headers{Array} 原始 header 條目組成的扁平列表偶數(shù)下標(biāo)是 header 名奇數(shù)下標(biāo)是對(duì)應(yīng)的值。每個(gè)條目可以是 {string}、{Buffer}或由 {string}/{Buffer} 組成的數(shù)組數(shù)組形式代表同一 header 的多個(gè)值如多條Set-Cookie。obj{Recordstring, string|string[]} 用于接收解析結(jié)果的對(duì)象省略時(shí)內(nèi)部會(huì)新建一個(gè)對(duì)象。默認(rèn)值{}。傳入obj時(shí)函數(shù)返回的是同一個(gè)引用便于把結(jié)果寫入你自己預(yù)先準(zhǔn)備的 accumulator。返回{Recordstring, string|string[]} 解析完成后的對(duì)象即傳入的obj若未傳則是新對(duì)象。2.2 行為規(guī)則名稱歸一化header 名統(tǒng)一轉(zhuǎn)小寫通過(guò)headerNameToString()處理因此Content-Type會(huì)變成content-type。Buffer 值解碼值為 {Buffer} 時(shí)按latin1而非 UTF-8解碼。重復(fù) header 合并同一 header 名出現(xiàn)多次時(shí)值會(huì)被收集進(jìn)一個(gè)數(shù)組首次出現(xiàn)時(shí)若值是數(shù)組形式例如[a1, b2]該數(shù)組會(huì)被保留。官方文檔示例import { util } from undici const raw [Content-Type, text/plain, Set-Cookie, a1, Set-Cookie, b2] console.log(util.parseHeaders(raw)) // { content-type: text/plain, set-cookie: [ a1, b2 ] }2.3 底層實(shí)現(xiàn)原理lib/core/util.js源碼實(shí)現(xiàn)位于 lib/core/util.js。關(guān)鍵邏輯可概括為以步長(zhǎng) 2 遍歷扁平數(shù)組i為偶數(shù)時(shí)取 header 名i 1為對(duì)應(yīng)值先通過(guò)headerNameToString(headers[i])得到規(guī)范化小寫名key若key在目標(biāo)對(duì)象中已存在且是自有屬性O(shè)bject.hasOwn則把首個(gè)字符串值升級(jí)為數(shù)組并把后續(xù)值push進(jìn)去若不存在則直接賦值值可能是字符串、數(shù)組或經(jīng) latin1 解碼的字符串對(duì)值條目做歸一化字符串原樣保留數(shù)組內(nèi)每個(gè)元素做toString(latin1)Buffer 做toString(latin1)。值得注意的細(xì)節(jié)是__proto__防護(hù)當(dāng) header 名恰好是__proto__時(shí)代碼通過(guò)Object.defineProperty寫入目標(biāo)對(duì)象避免觸發(fā)Object.prototype的__proto__setter普通賦值會(huì)丟棄字符串值、甚至在值為數(shù)組時(shí)替換對(duì)象原型。源碼中專門封裝了 setHeader 并在parseHeaders內(nèi)部對(duì)__proto__分支做相同處理這體現(xiàn)了 HTTP header 解析面對(duì)不可信輸入時(shí)的安全考量。2.4 測(cè)試用例印證test/node-test/util.js 中覆蓋了該函數(shù)的主要行為test(parseHeaders, () { assert.deepEqual(util.parseHeaders([key, value]), { key: value }) assert.deepEqual(util.parseHeaders([Buffer.from(key), Buffer.from(value)]), { key: value }) assert.deepEqual(util.parseHeaders([Key, Value]), { key: Value }) assert.deepEqual(util.parseHeaders([Key, value, key, Value]), { key: [value, Value] }) assert.deepEqual(util.parseHeaders([key, [value1, value2, value3]]), { key: [value1, value2, value3] }) assert.deepEqual(util.parseHeaders([Buffer.from(key), [Buffer.from(value1), Buffer.from(value2), Buffer.from(value3)]]), { key: [value1, value2, value3] }) })另有專門的測(cè)試test/node-test/util.js驗(yàn)證latin1 而非 UTF-8 解碼字節(jié)序列0xE2 0x80 0xA6是 UTF-8 編碼的省略號(hào)…U2026但按 latin1 解碼會(huì)得到 3 個(gè)獨(dú)立字符a € |測(cè)試斷言result[x-test].length 3且各碼位分別為0xe2、0x80、0xa6。這提醒使用者在解析含非 ASCII 的 header 值時(shí)應(yīng)遵循與 undici 一致的 latin1 語(yǔ)義。2.5 實(shí)戰(zhàn)利用obj參數(shù)合并到既有對(duì)象當(dāng)你需要把原始 header 追加進(jìn)自己維護(hù)的對(duì)象例如在多段響應(yīng)頭場(chǎng)景下持續(xù)累積可以直接傳入obj函數(shù)會(huì)返回同一個(gè)引用import { util } from undici const target { content-type: text/html } const result util.parseHeaders([Set-Cookie, a1, Set-Cookie, b2], target) console.log(result target) // true console.log(target) // { content-type: text/html, set-cookie: [a1, b2] }三、headerNameToString(value)高效的 header 名小寫化3.1 參數(shù)與返回值value{string|Buffer} 需要?dú)w一化的 header 名。返回{string} 小寫形式的 header 名。value可以是 {string} 或 {Buffer}Buffer 會(huì)按latin1解碼。常見(jiàn) header 名通過(guò)內(nèi)部查表解析以獲得更好性能見(jiàn)下節(jié)。官方文檔示例import { util } from undici console.log(util.headerNameToString(Content-Type)) // content-type console.log(util.headerNameToString(Buffer.from(X-Custom-Header))) // x-custom-header3.2 底層實(shí)現(xiàn)查表 三叉搜索樹(shù)源碼在 lib/core/util.jsfunction headerNameToString (value) { return typeof value string ? headerNameLowerCasedRecord[value] ?? value.toLowerCase() : tree.lookup(value) ?? value.toString(latin1).toLowerCase() }可以看到兩條路徑字符串輸入先在headerNameLowerCasedRecord中查表。該表來(lái)自 lib/core/constants.js其中收錄了 100 余個(gè)常見(jiàn) header 名如Content-Type、Set-Cookie、User-Agent等完整清單見(jiàn) lib/core/constants.js并同時(shí)以原始大小寫與全小寫兩種鍵存儲(chǔ)且通過(guò)Object.setPrototypeOf(record, null)置空原型避免原型污染。查不到時(shí)回退到value.toLowerCase()。Buffer 輸入走tree.lookup(value)其中tree是基于Ternary Search Tree三叉搜索樹(shù)實(shí)現(xiàn)的前綴索引見(jiàn) lib/core/tree.js。該樹(shù)在模塊加載時(shí)用wellknownHeaderNames的全部小寫形式構(gòu)建lib/core/tree.js并在search時(shí)對(duì)A-Z碼位0x41–0x5A做code | 32的原地小寫化從而能以字節(jié)級(jí)比較直接命中常見(jiàn) header 名查不到時(shí)回退為value.toString(latin1).toLowerCase()。這套“查表 → 三叉搜索樹(shù) → 兜底 toLowerCase”的三級(jí)策略是 undici 在 header 名歸一化上的典型性能優(yōu)化絕大多數(shù)真實(shí)流量中的 header 名都是常見(jiàn)名稱可以避免逐字符小寫化與字符串分配。3.3 相關(guān)函數(shù)與測(cè)試同一文件還導(dǎo)出了內(nèi)部使用的bufferToLowerCasedHeaderNamelib/core/util.js其邏輯與 Buffer 路徑一致tree.lookup(value) ?? value.toString(latin1).toLowerCase()供內(nèi)部調(diào)用方復(fù)用。TypeScript 類型測(cè)試見(jiàn) test/types/util.test-d.ts確認(rèn)了headerNameToString(content-type)與headerNameToString(Buffer.from(content-type))均返回string。四、在倉(cāng)庫(kù)內(nèi)部的實(shí)際使用場(chǎng)景雖然對(duì)外只暴露了這兩個(gè)函數(shù)但 header 歸一化與原始列表解析的邏輯遍布 undici 核心鏈路可作為理解自定義實(shí)現(xiàn)時(shí)應(yīng)如何對(duì)齊行為的參考redirect-handler.js 在重定向場(chǎng)景中使用util.headerNameToString(header)歸一化響應(yīng) header 名例如收集set-cookie等跨請(qǐng)求保留的 headerapi-request.js、api-stream.js、api-pipeline.js、api-connect.js、api-upgrade.js 等 API 層在把底層原始 header 回調(diào)轉(zhuǎn)換為用戶可見(jiàn)的響應(yīng)對(duì)象時(shí)均調(diào)用內(nèi)部util.parseRawHeaders(rawHeaders)做扁平化與規(guī)范化parseRawHeaderslib/core/util.js負(fù)責(zé)把對(duì)象形式的 header含數(shù)組值如set-cookie: [a1, b2]展開(kāi)為偶數(shù)下標(biāo)為名、奇數(shù)下標(biāo)為值的扁平數(shù)組與parseHeaders構(gòu)成“對(duì)象 ? 扁平數(shù)組”的雙向轉(zhuǎn)換其行為同樣被 test/node-test/util.js 覆蓋?？梢钥吹阶远x dispatcher/handler 若要完全對(duì)齊 undici 的語(yǔ)義小寫化、latin1 解碼、重復(fù) header 合并、__proto__防護(hù)直接復(fù)用導(dǎo)出的util.parseHeaders與util.headerNameToString是最穩(wěn)妥的做法。五、小結(jié)API輸入輸出核心行為性能手段parseHeaders(headers[, obj])扁平原始 header 列表string/Buffer/數(shù)組條目按小寫名組織的對(duì)象重復(fù)名合并為數(shù)組名稱小寫化、Buffer 值 latin1 解碼、重復(fù)值收集名稱歸一化復(fù)用headerNameToString值復(fù)用 latin1 解碼headerNameToString(value)string 或 Buffer小寫 header 名Buffer 按 latin1 解碼字符串查headerNameLowerCasedRecord表lib/core/constants.jsBuffer 走三叉搜索樹(shù)lib/core/tree.jsutil工具集自 v1.2.0 引入parseHeaders在 v6.1.0 起接受并歸一化 Buffer 形式的 header 名headerNameToString也在 v6.1.0 加入。對(duì)于任何需要實(shí)現(xiàn)自定義Dispatcher的開(kāi)發(fā)者這兩個(gè)工具是你與 undici 內(nèi)部 header 語(yǔ)義保持一致的最短路徑對(duì)于想深入理解 HTTP 客戶端 header 處理性能優(yōu)化的讀者lib/core/util.js、lib/core/constants.js 與 lib/core/tree.js 三份源碼值得完整閱讀。如需了解配套的Dispatcher接口約定可繼續(xù)閱讀 docs/docs/api/Dispatcher.md。贊分享后端網(wǎng)絡(luò)通信【免費(fèi)下載鏈接】undiciAn HTTP/1.1 client, written from scratch for Node.js項(xiàng)目地址https://gitcode.com/gh_mirrors/un/undici點(diǎn)擊查看免費(fèi)下載相關(guān)推薦discordjs/util 工具包深度解析discord.js 跨運(yùn)行時(shí)公共工具庫(kù)的源碼實(shí)現(xiàn)與實(shí)戰(zhàn)指南discordjs/util 工具包深度解析discord.js 跨運(yùn)行時(shí)公共工具庫(kù)的源碼實(shí)現(xiàn)與實(shí)戰(zhàn)指南 discordjs/util 是 discord后端Amplication util-kafka 庫(kù)實(shí)戰(zhàn)指南框架無(wú)關(guān)的 Kafka 集成工具與 JSON 序列化實(shí)現(xiàn)Amplication util kafka 庫(kù)實(shí)戰(zhàn)指南框架無(wú)關(guān)的 Kafka 集成工具與 JSON 序列化實(shí)現(xiàn) 導(dǎo)讀 libs/util/kafka 是 A后端代碼生成低代碼AI 應(yīng)用SmartTube Android TV播放器架構(gòu)解析與深度部署指南SmartTube Android TV播放器架構(gòu)解析與深度部署指南 SmartTube是一款專為Android TV和電視盒子設(shè)計(jì)的開(kāi)源媒體播放器應(yīng)用提供無(wú)音視頻客戶端上一篇簡(jiǎn)單三步Butterfly主題CSS變量完全指南讓你的博客顏色隨心換下一篇LevelDB 深度解析Google 鍵值存儲(chǔ)庫(kù)的特性、CMake 構(gòu)建指南、性能報(bào)告與頭文件導(dǎo)航創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 undici Util 工具集實(shí)戰(zhàn)指南：深入 parseHeaders 與 headerNameToString
后端網(wǎng)絡(luò)通信【免費(fèi)下載鏈接】undiciAn HTTP/1.1 client, written from scratch for Node.js項(xiàng)目地址https://gitcode.com/gh_mirrors/un/undici點(diǎn)擊查看免費(fèi)下載本文以 undiciNode.js 從零實(shí)現(xiàn)的 HTTP/1.1 客戶端暴露的util工具集為主線完整講解parseHeaders與headerNameToString兩個(gè)核心工具的用法、底層實(shí)現(xiàn)與內(nèi)部調(diào)用場(chǎng)景。讀完本文你將能夠在自定義Dispatcher/ Handler 實(shí)現(xiàn)中以與 undici 完全一致的方式完成 header 名歸一化與扁平原始 header 列表解析并理解其背后的性能設(shè)計(jì)常見(jiàn) header 名查表 三叉搜索樹(shù)與編碼細(xì)節(jié)latin1 解碼。一、util工具集是什么為什么需要它undici 的util是一小組面向第三方Dispatcher實(shí)現(xiàn)的工具函數(shù)lib/core/util.js 中實(shí)現(xiàn)從 v1.2.0 起對(duì)外暴露當(dāng)前穩(wěn)定性等級(jí)為Stable2。它覆蓋了 undici 內(nèi)部使用的 header 處理原語(yǔ)目的是讓自定義 dispatcher 和 handler 能“與 undici 完全一致地”規(guī)范化 header 名稱、解析原始 header 列表——例如Set-Cookie這類可重復(fù) header 的合并行為以及大小寫歸一化規(guī)則。在 index.js 中對(duì)外導(dǎo)出的util對(duì)象只暴露了兩個(gè)函數(shù)module.exports.util { parseHeaders: util.parseHeaders, headerNameToString: util.headerNameToString }也就是說(shuō)從包外部你能拿到的就是這兩個(gè) API。引入方式如下// ESM import { util } from undici const { parseHeaders, headerNameToString } util// CommonJS const { util } require(undici) const { parseHeaders, headerNameToString } util同時(shí) types/util.d.ts 提供了完整的 TypeScript 類型聲明函數(shù)簽名如下export function headerNameToString (value: string | Buffer): string export function parseHeaders ( headers: (Buffer | string | (Buffer | string)[])[], obj?: Recordstring, string | string[] ): Recordstring, string | string[]二、parseHeaders(headers[, obj])扁平 header 列表 → 規(guī)范對(duì)象2.1 參數(shù)與返回值headers{Array} 原始 header 條目組成的扁平列表偶數(shù)下標(biāo)是 header 名奇數(shù)下標(biāo)是對(duì)應(yīng)的值。每個(gè)條目可以是 {string}、{Buffer}或由 {string}/{Buffer} 組成的數(shù)組數(shù)組形式代表同一 header 的多個(gè)值如多條Set-Cookie。obj{Recordstring, string|string[]} 用于接收解析結(jié)果的對(duì)象省略時(shí)內(nèi)部會(huì)新建一個(gè)對(duì)象。默認(rèn)值{}。傳入obj時(shí)函數(shù)返回的是同一個(gè)引用便于把結(jié)果寫入你自己預(yù)先準(zhǔn)備的 accumulator。返回{Recordstring, string|string[]} 解析完成后的對(duì)象即傳入的obj若未傳則是新對(duì)象。2.2 行為規(guī)則名稱歸一化header 名統(tǒng)一轉(zhuǎn)小寫通過(guò)headerNameToString()處理因此Content-Type會(huì)變成content-type。Buffer 值解碼值為 {Buffer} 時(shí)按latin1而非 UTF-8解碼。重復(fù) header 合并同一 header 名出現(xiàn)多次時(shí)值會(huì)被收集進(jìn)一個(gè)數(shù)組首次出現(xiàn)時(shí)若值是數(shù)組形式例如[a1, b2]該數(shù)組會(huì)被保留。官方文檔示例import { util } from undici const raw [Content-Type, text/plain, Set-Cookie, a1, Set-Cookie, b2] console.log(util.parseHeaders(raw)) // { content-type: text/plain, set-cookie: [ a1, b2 ] }2.3 底層實(shí)現(xiàn)原理lib/core/util.js源碼實(shí)現(xiàn)位于 lib/core/util.js。關(guān)鍵邏輯可概括為以步長(zhǎng) 2 遍歷扁平數(shù)組i為偶數(shù)時(shí)取 header 名i 1為對(duì)應(yīng)值先通過(guò)headerNameToString(headers[i])得到規(guī)范化小寫名key若key在目標(biāo)對(duì)象中已存在且是自有屬性O(shè)bject.hasOwn則把首個(gè)字符串值升級(jí)為數(shù)組并把后續(xù)值push進(jìn)去若不存在則直接賦值值可能是字符串、數(shù)組或經(jīng) latin1 解碼的字符串對(duì)值條目做歸一化字符串原樣保留數(shù)組內(nèi)每個(gè)元素做toString(latin1)Buffer 做toString(latin1)。值得注意的細(xì)節(jié)是__proto__防護(hù)當(dāng) header 名恰好是__proto__時(shí)代碼通過(guò)Object.defineProperty寫入目標(biāo)對(duì)象避免觸發(fā)Object.prototype的__proto__setter普通賦值會(huì)丟棄字符串值、甚至在值為數(shù)組時(shí)替換對(duì)象原型。源碼中專門封裝了 setHeader 并在parseHeaders內(nèi)部對(duì)__proto__分支做相同處理這體現(xiàn)了 HTTP header 解析面對(duì)不可信輸入時(shí)的安全考量。2.4 測(cè)試用例印證test/node-test/util.js 中覆蓋了該函數(shù)的主要行為test(parseHeaders, () { assert.deepEqual(util.parseHeaders([key, value]), { key: value }) assert.deepEqual(util.parseHeaders([Buffer.from(key), Buffer.from(value)]), { key: value }) assert.deepEqual(util.parseHeaders([Key, Value]), { key: Value }) assert.deepEqual(util.parseHeaders([Key, value, key, Value]), { key: [value, Value] }) assert.deepEqual(util.parseHeaders([key, [value1, value2, value3]]), { key: [value1, value2, value3] }) assert.deepEqual(util.parseHeaders([Buffer.from(key), [Buffer.from(value1), Buffer.from(value2), Buffer.from(value3)]]), { key: [value1, value2, value3] }) })另有專門的測(cè)試test/node-test/util.js驗(yàn)證latin1 而非 UTF-8 解碼字節(jié)序列0xE2 0x80 0xA6是 UTF-8 編碼的省略號(hào)…U2026但按 latin1 解碼會(huì)得到 3 個(gè)獨(dú)立字符a € |測(cè)試斷言result[x-test].length 3且各碼位分別為0xe2、0x80、0xa6。這提醒使用者在解析含非 ASCII 的 header 值時(shí)應(yīng)遵循與 undici 一致的 latin1 語(yǔ)義。2.5 實(shí)戰(zhàn)利用obj參數(shù)合并到既有對(duì)象當(dāng)你需要把原始 header 追加進(jìn)自己維護(hù)的對(duì)象例如在多段響應(yīng)頭場(chǎng)景下持續(xù)累積可以直接傳入obj函數(shù)會(huì)返回同一個(gè)引用import { util } from undici const target { content-type: text/html } const result util.parseHeaders([Set-Cookie, a1, Set-Cookie, b2], target) console.log(result target) // true console.log(target) // { content-type: text/html, set-cookie: [a1, b2] }三、headerNameToString(value)高效的 header 名小寫化3.1 參數(shù)與返回值value{string|Buffer} 需要?dú)w一化的 header 名。返回{string} 小寫形式的 header 名。value可以是 {string} 或 {Buffer}Buffer 會(huì)按latin1解碼。常見(jiàn) header 名通過(guò)內(nèi)部查表解析以獲得更好性能見(jiàn)下節(jié)。官方文檔示例import { util } from undici console.log(util.headerNameToString(Content-Type)) // content-type console.log(util.headerNameToString(Buffer.from(X-Custom-Header))) // x-custom-header3.2 底層實(shí)現(xiàn)查表 三叉搜索樹(shù)源碼在 lib/core/util.jsfunction headerNameToString (value) { return typeof value string ? headerNameLowerCasedRecord[value] ?? value.toLowerCase() : tree.lookup(value) ?? value.toString(latin1).toLowerCase() }可以看到兩條路徑字符串輸入先在headerNameLowerCasedRecord中查表。該表來(lái)自 lib/core/constants.js其中收錄了 100 余個(gè)常見(jiàn) header 名如Content-Type、Set-Cookie、User-Agent等完整清單見(jiàn) lib/core/constants.js并同時(shí)以原始大小寫與全小寫兩種鍵存儲(chǔ)且通過(guò)Object.setPrototypeOf(record, null)置空原型避免原型污染。查不到時(shí)回退到value.toLowerCase()。Buffer 輸入走tree.lookup(value)其中tree是基于Ternary Search Tree三叉搜索樹(shù)實(shí)現(xiàn)的前綴索引見(jiàn) lib/core/tree.js。該樹(shù)在模塊加載時(shí)用wellknownHeaderNames的全部小寫形式構(gòu)建lib/core/tree.js并在search時(shí)對(duì)A-Z碼位0x41–0x5A做code | 32的原地小寫化從而能以字節(jié)級(jí)比較直接命中常見(jiàn) header 名查不到時(shí)回退為value.toString(latin1).toLowerCase()。這套“查表 → 三叉搜索樹(shù) → 兜底 toLowerCase”的三級(jí)策略是 undici 在 header 名歸一化上的典型性能優(yōu)化絕大多數(shù)真實(shí)流量中的 header 名都是常見(jiàn)名稱可以避免逐字符小寫化與字符串分配。3.3 相關(guān)函數(shù)與測(cè)試同一文件還導(dǎo)出了內(nèi)部使用的bufferToLowerCasedHeaderNamelib/core/util.js其邏輯與 Buffer 路徑一致tree.lookup(value) ?? value.toString(latin1).toLowerCase()供內(nèi)部調(diào)用方復(fù)用。TypeScript 類型測(cè)試見(jiàn) test/types/util.test-d.ts確認(rèn)了headerNameToString(content-type)與headerNameToString(Buffer.from(content-type))均返回string。四、在倉(cāng)庫(kù)內(nèi)部的實(shí)際使用場(chǎng)景雖然對(duì)外只暴露了這兩個(gè)函數(shù)但 header 歸一化與原始列表解析的邏輯遍布 undici 核心鏈路可作為理解自定義實(shí)現(xiàn)時(shí)應(yīng)如何對(duì)齊行為的參考redirect-handler.js 在重定向場(chǎng)景中使用util.headerNameToString(header)歸一化響應(yīng) header 名例如收集set-cookie等跨請(qǐng)求保留的 headerapi-request.js、api-stream.js、api-pipeline.js、api-connect.js、api-upgrade.js 等 API 層在把底層原始 header 回調(diào)轉(zhuǎn)換為用戶可見(jiàn)的響應(yīng)對(duì)象時(shí)均調(diào)用內(nèi)部util.parseRawHeaders(rawHeaders)做扁平化與規(guī)范化parseRawHeaderslib/core/util.js負(fù)責(zé)把對(duì)象形式的 header含數(shù)組值如set-cookie: [a1, b2]展開(kāi)為偶數(shù)下標(biāo)為名、奇數(shù)下標(biāo)為值的扁平數(shù)組與parseHeaders構(gòu)成“對(duì)象 ? 扁平數(shù)組”的雙向轉(zhuǎn)換其行為同樣被 test/node-test/util.js 覆蓋?？梢钥吹阶远x dispatcher/handler 若要完全對(duì)齊 undici 的語(yǔ)義小寫化、latin1 解碼、重復(fù) header 合并、__proto__防護(hù)直接復(fù)用導(dǎo)出的util.parseHeaders與util.headerNameToString是最穩(wěn)妥的做法。五、小結(jié)API輸入輸出核心行為性能手段parseHeaders(headers[, obj])扁平原始 header 列表string/Buffer/數(shù)組條目按小寫名組織的對(duì)象重復(fù)名合并為數(shù)組名稱小寫化、Buffer 值 latin1 解碼、重復(fù)值收集名稱歸一化復(fù)用headerNameToString值復(fù)用 latin1 解碼headerNameToString(value)string 或 Buffer小寫 header 名Buffer 按 latin1 解碼字符串查headerNameLowerCasedRecord表lib/core/constants.jsBuffer 走三叉搜索樹(shù)lib/core/tree.jsutil工具集自 v1.2.0 引入parseHeaders在 v6.1.0 起接受并歸一化 Buffer 形式的 header 名headerNameToString也在 v6.1.0 加入。對(duì)于任何需要實(shí)現(xiàn)自定義Dispatcher的開(kāi)發(fā)者這兩個(gè)工具是你與 undici 內(nèi)部 header 語(yǔ)義保持一致的最短路徑對(duì)于想深入理解 HTTP 客戶端 header 處理性能優(yōu)化的讀者lib/core/util.js、lib/core/constants.js 與 lib/core/tree.js 三份源碼值得完整閱讀。如需了解配套的Dispatcher接口約定可繼續(xù)閱讀 docs/docs/api/Dispatcher.md。贊分享后端網(wǎng)絡(luò)通信【免費(fèi)下載鏈接】undiciAn HTTP/1.1 client, written from scratch for Node.js項(xiàng)目地址https://gitcode.com/gh_mirrors/un/undici點(diǎn)擊查看免費(fèi)下載相關(guān)推薦discordjs/util 工具包深度解析discord.js 跨運(yùn)行時(shí)公共工具庫(kù)的源碼實(shí)現(xiàn)與實(shí)戰(zhàn)指南discordjs/util 工具包深度解析discord.js 跨運(yùn)行時(shí)公共工具庫(kù)的源碼實(shí)現(xiàn)與實(shí)戰(zhàn)指南 discordjs/util 是 discord后端Amplication util-kafka 庫(kù)實(shí)戰(zhàn)指南框架無(wú)關(guān)的 Kafka 集成工具與 JSON 序列化實(shí)現(xiàn)Amplication util kafka 庫(kù)實(shí)戰(zhàn)指南框架無(wú)關(guān)的 Kafka 集成工具與 JSON 序列化實(shí)現(xiàn) 導(dǎo)讀 libs/util/kafka 是 A后端代碼生成低代碼AI 應(yīng)用SmartTube Android TV播放器架構(gòu)解析與深度部署指南SmartTube Android TV播放器架構(gòu)解析與深度部署指南 SmartTube是一款專為Android TV和電視盒子設(shè)計(jì)的開(kāi)源媒體播放器應(yīng)用提供無(wú)音視頻客戶端上一篇簡(jiǎn)單三步Butterfly主題CSS變量完全指南讓你的博客顏色隨心換下一篇LevelDB 深度解析Google 鍵值存儲(chǔ)庫(kù)的特性、CMake 構(gòu)建指南、性能報(bào)告與頭文件導(dǎo)航創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考