contextualIdentities

使用上下文身份：列出、建立、移除和更新上下文身份。

“上下文身份”（也稱為“容器”）是一項瀏覽器功能，允許使用者在瀏覽網頁時擁有多個身份，並在此類身份之間保持一定的隔離。例如，使用者可能認為他們的“工作身份”與“個人身份”是分開的，並且不希望在這些上下文之間共享 cookie。

藉助上下文身份功能，每個上下文身份都有一個名稱、一種顏色和一個圖示。新標籤頁可以分配給某個身份，並且名稱、圖示和顏色會顯示在位址列中。在內部，每個身份都有一個不與其他標籤頁共享的 cookie 儲存。在當前及其他 API 中，此 cookie 儲存由 cookieStoreId 標識。

上下文身份是 Firefox 中的一項實驗性功能，並且預設情況下僅在 Firefox Nightly 中啟用。要在其他版本的 Firefox 中啟用它們，請將 privacy.userContext.enabled 首選項設定為 true。請注意，雖然上下文身份在 Firefox for Android 中可用，但在該瀏覽器版本中沒有用於操作它們的 UI。

在 Firefox 57 之前，只有當上下文身份功能本身啟用時，contextualIdentities API 才可用。如果擴充套件在功能未啟用時嘗試使用 contextualIdentities API，則方法呼叫將以 false 解析其 Promise。

從 Firefox 57 開始，如果安裝了使用 contextualIdentities API 的擴充套件，則上下文身份功能將自動啟用。但請注意，使用者仍然可以透過“privacy.userContext.enabled”首選項停用該功能。如果發生這種情況，contextualIdentities 方法呼叫將以錯誤訊息拒絕其 Promise。

有關更多資訊，請參閱 使用上下文身份。

其他瀏覽器均不支援上下文身份。

要使用此 API，您需要在 manifest.json 檔案中包含 "contextualIdentities" 和 "cookies" 許可權。