chrome.search

說明

使用 chrome.search API 透過預設提供者搜尋。

權限

search

可用性

Chrome 87 以上版本

類型

Disposition

列舉

"CURRENT_TAB"
指定搜尋結果會顯示在使用中瀏覽器的分頁或分頁中。

"NEW_TAB"
指定搜尋結果會顯示在新分頁中。

"NEW_WINDOW"
指定搜尋結果會顯示在新視窗中。

QueryInfo

屬性

  • disposition

    處理方式 選用

    要顯示搜尋結果的位置。預設值為 CURRENT_TAB

  • tabId

    編號 選填

    要顯示搜尋結果的位置。tabId 無法與 disposition 搭配使用。

  • 文字

    字串

    要使用預設搜尋引擎查詢的字串。

方法

query()

Promise
chrome.search.query(
  queryInfo: QueryInfo,
  callback?: function,
)

用於查詢預設搜尋引擎。如果發生錯誤,系統會設定 runtime.lastError

參數

  • queryInfo
  • 回呼

    函式 選用

    callback 參數如下所示:

    () => void

傳回

  • 承諾<void>

    Chrome 96 以上版本

    Promise 適用於 Manifest V3 及以上版本,但系統會為 回溯相容性您無法在同一函式呼叫中同時使用兩者。 保證會以傳遞至回呼的相同類型來解析。