chrome.search

说明

使用 chrome.search API 通过默认提供程序进行搜索。

权限

search

可用性

Chrome 87 及更高版本

类型

Disposition

枚举

“CURRENT_TAB”
指定搜索结果显示在调用标签页或活动浏览器中的标签页中。

“NEW_TAB”
指定搜索结果显示在新标签页中。

“NEW_WINDOW”
指定搜索结果显示在新窗口中。

QueryInfo

属性

  • disposition

    处置（可选）

    应显示搜索结果的位置。默认为 CURRENT_TAB。

  • tabId

    number 可选

    应显示搜索结果的位置。tabId 无法与 disposition 搭配使用。

  • text

    字符串

    要使用默认搜索服务提供商查询的字符串。

方法

query()

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

用于查询默认搜索服务提供商。如果出现错误，系统会设置 runtime.lastError。

参数

  • queryInfo

    QueryInfo

  • callback

    函数 可选

    callback 参数如下所示： 

    () => void

返回

  • Promise<void>

    Chrome 96 及更高版本

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。