search.query()
使用瀏覽器預設的搜尋引擎執行搜尋。
搜尋結果根據 disposition 屬性顯示在當前標籤頁、新標籤頁或新視窗中,或者顯示在 tabId 屬性指定的標籤頁中。如果兩者都沒有指定,則結果顯示在當前標籤頁中。
要使用此函式,您的擴充套件必須具有 "search" manifest 許可權。
語法
js
browser.search.query(
queryInfo // object
)
引數
queryInfo-
object。一個具有以下屬性的物件。disposition可選-
string。搜尋結果顯示的位置。有效值為CURRENT_TAB、NEW_TAB和NEW_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);
瀏覽器相容性
載入中…