chrome.search

refresh date: 2026-09-25 robots: noindex

說明

使用 chrome.search API 透過預設供應器搜尋。

權限

search

可用性

Chrome 87 以上版本

類型

Disposition

列舉

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

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

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

QueryInfo

屬性

  • disposition

    Disposition 選用

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

  • tabId

    數字 選填

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

  • 文字

    字串

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

方法

query()

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

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

參數

  • queryInfo

    QueryInfo

  • callback

    函式 選填

    callback 參數如下： 

    () => void

傳回

  • 承諾<void>

    Chrome 96 以上版本

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