說明
使用 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 及以上版本,但系統會為 回溯相容性您無法在同一函式呼叫中同時使用兩者。 保證會以傳遞至回呼的相同類型來解析。