Sec-CH-UA

實驗性： 這是一個 實驗性技術
在生產環境中使用此功能之前，請仔細檢視 瀏覽器相容性表格。

安全上下文： 此功能僅在 安全上下文（HTTPS）中可用，某些或所有 支援的瀏覽器 中均可使用。

Sec-CH-UA 使用者代理客戶端提示 請求頭提供使用者代理的品牌和重要版本資訊。

報頭型別 請求頭，客戶端提示
禁止的報頭名稱 是

Sec-CH-UA 標頭以逗號分隔的列表形式提供與瀏覽器關聯的每個品牌的品牌和重要版本。

品牌是使用者代理的商業名稱，例如：Chromium、Opera、Google Chrome、Microsoft Edge、Firefox 和 Safari。使用者代理可能具有多個關聯的品牌。例如，Opera、Chrome 和 Edge 都基於 Chromium，並且將在 Sec-CH-UA 標頭中提供這兩個品牌。

重要版本 是用於區分品牌主要版本的“營銷”版本識別符號。例如，具有完整版本號“96.0.4664.45”的 Chromium 版本的重要版本號為“96”。

因此，該標頭允許伺服器根據共享品牌及其各自版本中的特定自定義設定自定義其響應。

Sec-CH-UA 是一個 低熵提示。除非被使用者代理許可權策略阻止，否則它會預設傳送，而無需伺服器透過傳送 Accept-CH 來選擇加入。

標頭可以在任何位置和任何名稱下包含“偽造”品牌。這是一項旨在防止伺服器直接拒絕未知使用者代理的功能，迫使使用者代理對其品牌標識進行虛假陳述。

注意： Sec-CH-UA-Full-Version-List 與 Sec-CH-UA 相同，但包括每個品牌的完整版本號，而不是重要版本號。

語法

使用者代理品牌列表中品牌的逗號分隔列表及其關聯的重要版本號。單個條目的語法具有以下格式

http
Sec-CH-UA: "<brand>";v="<significant version>", ...

指令

<brand>

與使用者代理關聯的品牌，例如“Chromium”、“Google Chrome”或故意錯誤的品牌，例如 "Not A;Brand"。

<significant version>

與可區分的網路公開功能關聯的“營銷”版本號。

示例

Sec-CH-UA 是一個 低熵提示。除非使用者代理策略明確阻止，否則它將在所有請求中傳送（無需伺服器透過傳送 Accept-CH 來選擇加入）。

Chromium、Chrome、Edge 和 Opera 桌面瀏覽器的字串顯示如下。請注意，它們都共享“Chromium”品牌，但還有一個指示其來源的附加品牌。它們還有一個故意錯誤的品牌字串，該字串可能出現在任何位置並具有不同的文字。

http
Sec-CH-UA: "(Not(A:Brand";v="8", "Chromium";v="98"
http
Sec-CH-UA: " Not A;Brand";v="99", "Chromium";v="96", "Google Chrome";v="96"
http
Sec-CH-UA: " Not A;Brand";v="99", "Chromium";v="96", "Microsoft Edge";v="96"
http
Sec-CH-UA: "Opera";v="81", " Not;A Brand";v="99", "Chromium";v="95"

規範

規範
使用者代理客戶端提示
# sec-ch-ua

瀏覽器相容性

BCD 表格僅在啟用 JavaScript 的瀏覽器中載入。

另請參閱