chrome.search

說明

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

權限

search

適用國家/地區

Chrome 87 以上版本

類型

Disposition

列舉

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

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

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

QueryInfo

屬性

  • disposition

    處理 選用

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

  • tabId

    數字 選填

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

  • text

    字串

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

方法

query()

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

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

參數

  • queryInfo

    QueryInfo

  • 回呼

    函式選用

    callback 參數如下所示： 

    ()=>void

傳回

  • Promise<void>

    Chrome 96 以上版本

    Manifest V3 以上版本支援 Promise，但是為了提供回溯相容性而提供的回呼。您無法在同一個函式呼叫中同時使用這兩者。承諾會用傳遞至回呼的同類型解析。