伺服器時序

Server-Timing 標頭的語法允許您以不同的方式通訊度量值：僅伺服器度量值名稱、帶值的度量值、帶值和描述的度量值以及帶描述的度量值。

此標頭可以包含一個或多個度量值，用逗號分隔。每個度量值都有一個名稱、可選的持續時間和可選的描述。這些元件用分號分隔。

持續時間元件由字串 "dur"、後跟 "="，然後是值組成，例如 "dur=23.2"。描述元件由字串 "desc"、後跟 "="，然後是值組成，例如 "desc=DB lookup"。

規範建議名稱和描述應儘可能簡短（使用縮寫並省略可選值，只要可能），以最大限度地減少 HTTP 開銷。

// Single metric without value
Server-Timing: missedCache

// Single metric with value
Server-Timing: cpu;dur=2.4

// Single metric with description and value
Server-Timing: cache;desc="Cache Read";dur=23.2

// Two metrics with value
Server-Timing: db;dur=53, app;dur=47.2

// Server-Timing as trailer
Trailer: Server-Timing
--- response body ---
Server-Timing: total;dur=123.4

Server-Timing 標頭可能會公開潛在的敏感應用程式和基礎設施資訊。請考慮在伺服器端控制何時以及向誰返回哪些度量值。例如，您可以在伺服器端僅向已驗證使用者顯示度量值，而不對公眾顯示任何內容。

除了讓 Server-Timing 標頭度量值顯示在瀏覽器的開發人員工具中外，PerformanceServerTiming 介面還使工具能夠自動從 JavaScript 收集和處理度量值。此介面僅限於同一來源，但您可以使用 Timing-Allow-Origin 標頭指定允許訪問伺服器度量值的域。此介面僅在某些瀏覽器中以安全上下文（HTTPS）提供。

Server-Timing 標頭的元件對映到 PerformanceServerTiming 屬性的方式如下

• "name" -> PerformanceServerTiming.name
• "dur" -> PerformanceServerTiming.duration
• "desc" -> PerformanceServerTiming.description

• PerformanceServerTiming