chrome.search

说明

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

权限

search

可用性

Chrome 87 及更高版本

类型

Disposition

枚举

"CURRENT_TAB"
指定搜索结果显示在发起调用的标签页中或当前所用浏览器的标签页中。

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

"NEW_WINDOW"
指定搜索结果在新窗口中打开。

QueryInfo

属性

  • disposition

    Disposition（可选）

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

  • tabId

    编号（选填）

    应显示搜索结果的位置。tabId 不能与 disposition 一起使用。

  • text

    字符串

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

方法

query()

<ph type="x-smartling-placeholder"></ph> 承诺 
chrome.search.query(
  queryInfo: QueryInfo,
  callback?: function,
)

用于查询默认的搜索服务提供商。如果发生错误，系统将设置 runtime.lastError。

参数

  • queryInfo

    QueryInfo

  • callback

    函数（可选）

    callback 参数如下所示： 

    () => void

返回

  • 承诺<void>

    Chrome 96 及更高版本

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