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

    QueryInfo

  • 回呼

    函式 選用

    callback 參數如下所示： 

    () => void

傳回

  • 承諾<void>

    Chrome 96 以上版本

    Promise 僅適用於 Manifest V3 及以上版本，其他平台需要使用回呼。