search.query()

使用瀏覽器預設的搜尋引擎執行搜尋。

搜尋結果根據 disposition 屬性顯示在當前標籤頁、新標籤頁或新視窗中,或者顯示在 tabId 屬性指定的標籤頁中。如果兩者都沒有指定,則結果顯示在當前標籤頁中。

要使用此函式,您的擴充套件必須具有 "search" manifest 許可權

語法

js
browser.search.query(
  queryInfo             // object
)

引數

queryInfo

object。一個具有以下屬性的物件。

disposition 可選

string。搜尋結果顯示的位置。有效值為 CURRENT_TABNEW_TABNEW_WINDOW。預設為 CURRENT_TAB。不能與 tabId 同時指定。

tabId 可選

integer。要在其中執行搜尋的標籤頁的可選識別符號。如果省略此屬性,搜尋結果將顯示在新標籤頁中。不能與 disposition 同時指定。

文字

string。搜尋查詢。

返回值

無。

示例

在當前標籤頁中顯示結果的搜尋(預設)

js
function search() {
  browser.search.query({
    text: "styracosaurus",
  });
}

browser.browserAction.onClicked.addListener(search);

在新視窗中顯示結果的搜尋

js
function search() {
  browser.search.query({
    text: "styracosaurus",
    disposition: "NEW_WINDOW",
  });
}

browser.browserAction.onClicked.addListener(search);

在特定標籤頁中顯示結果的搜尋

js
function search(tab) {
  browser.search.query({
    query: "styracosaurus",
    tabId: tab.id,
  });
}

browser.browserAction.onClicked.addListener(search);

瀏覽器相容性