contextualIdentities.query()

獲取有關所有上下文標識的資訊,或有關與給定篩選器引數匹配的上下文標識的資訊。

這是一個非同步函式,返回一個 Promise

語法

js
let getContext = browser.contextualIdentities.query(
  details                  // object
)

引數

details

object。一個可用於篩選返回的上下文標識的物件。這可能包含以下任何屬性:

name 可選

string。僅返回名稱為此字串的上下文標識。

返回值

一個 Promise,它將以一個 ContextualIdentity 物件陣列完成,每個物件描述一個單獨的標識。如果上下文標識功能未啟用,則 Promise 將被拒絕。

示例

檢索所有上下文標識,並記錄它們的名稱

js
function onGot(contexts) {
  for (const context of contexts) {
    console.log(`Name: ${context.name}`);
  }
}

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

browser.contextualIdentities.query({}).then(onGot, onError);

檢索所有名稱為“my-thing”的上下文標識,並記錄它們的名稱

js
function onGot(contexts) {
  for (const context of contexts) {
    console.log(`Name: ${context.name}`);
  }
}

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

browser.contextualIdentities
  .query({
    name: "my-thing",
  })
  .then(onGot, onError);

擴充套件程式示例

瀏覽器相容性