contextualIdentities.create()

語法

let createContext = browser.contextualIdentities.create(
  details                  // object
)

引數

details

object。一個包含新上下文身份屬性的物件。它包含以下屬性

name

string。新身份的名稱。這將在瀏覽器 UI 中顯示，使使用者能夠開啟屬於該身份的新標籤頁。它還將顯示在此身份所屬的標籤頁的 URL 欄中。

color

string。與新身份關聯的顏色。這將用於突出顯示屬於此身份的標籤頁。您可以在此處提供以下任何值

• "blue"
• "turquoise"
• "green"
• "yellow"
• "orange"
• "red"
• "pink"
• "purple"
• "toolbar"

icon

string。一個圖示的名稱，用於在此身份所屬的標籤頁的 URL 欄中顯示。您可以在此處提供以下任何值

• "fingerprint"
• "briefcase"
• "dollar"
• "cart"
• "circle"
• "gift"
• "vacation"
• "food"
• "fruit"
• "pet"
• "tree"
• "chill"
• "fence"

返回值

一個 Promise，它將以描述新身份的 ContextualIdentity 來兌現。如果上下文身份功能未啟用，則 Promise 將被拒絕。

示例

此示例建立一個新的上下文身份並記錄其 Cookie 儲存 ID

function onCreated(context) {
  console.log(`New identity's ID: ${context.cookieStoreId}.`);
}

function onError(e) {
  console.error(e);
}

browser.contextualIdentities
  .create({
    name: "my-thing",
    color: "purple",
    icon: "briefcase",
  })
  .then(onCreated, onError);

瀏覽器相容性