在 Chrome 中偵測第三方 Cookie 可用性

Chrome 提出新體驗,讓使用者選擇瀏覽時如何處理第三方 Cookie。網站和服務可能需要偵測特定情境下是否能使用第三方 Cookie。Chrome 主要透過兩種方法,偵測嵌入內容是否存取第三方 Cookie:使用 hasStorageAccess JavaScript 方法,以及觀察 Sec-Fetch-Storage-Access 標頭。

Privacy Sandbox 導入了 API,在符合特定條件時,可授予特定頁框第三方 Cookie 的存取權。因此,請務必偵測每個嵌入項目是否存取未分區 Cookie。

偵測 iframe 中的第三方 Cookie 存取權

如果 iframe 內容託管的網站與使用者網址列中顯示的網站不同,就會視為跨網站,且可能受到第三方 Cookie 限制。iframe 可以呼叫 await document.hasStorageAccess(),偵測目前是否能存取第三方 Cookie。這個方法會傳回 true 或 false,取決於頁框是否能存取未分區 Cookie。

如果 iframe 使用 Storage Access API (SAA) 存取未分區的跨網站 Cookie (單獨使用 SAA 或搭配相關網站集合),您可以檢查 storage-access 權限,判斷 iframe 是否可以選擇加入存取未分區的 Cookie。

偵測 HTTP 要求中的第三方 Cookie 存取行為

從 Chrome 133 開始,系統會傳送 Sec-Fetch-Storage-Access 標頭和憑證要求,讓伺服器知道其呼叫情境是否能存取未分區 Cookie。這個標頭包含下列其中一個值:

  • none:嵌入項目無法存取未分區 Cookie
  • inactive:嵌入項目有權存取未分區 Cookie,但尚未啟用
  • active:嵌入項目可存取未分區 Cookie

授予嵌入項目未分區 Cookie 存取權的條件

如果未分區第三方 Cookie 提供必要功能,您可以透過多種方式授予存取權。下列方法會授予未分區 Cookie 存取權。在某些情況下,必須先呼叫 requestStorageAccess() 或 requestStorageAccessFor(),才能授予存取權。

方法 範例 是否必須呼叫 requestStorageAccess?
Storage Access API提示 系統提示使用者授予儲存空間存取權,使用者選取「允許」。 是
Federated Credential Management 使用者透過聯合識別資訊提供者 (IdP) 登入,IdP 的框架要求儲存空間存取權。 是
相關網站集合 嵌入內容和嵌入器屬於同一個 RWS。 是
在使用者設定中啟用 3PC 使用者選擇允許所有瀏覽活動或僅限特定來源使用第三方 Cookie。 否
企業政策 公司的 Chrome Enterprise 管理員選擇允許部分或所有流量使用第三方 Cookie。 否