chrome.search

说明

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

权限

search

可用性

Chrome 87 及更高版本

类型

Disposition

枚举

"CURRENT_TAB"
指定在通话标签页或当前浏览器的标签页中显示搜索结果。

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

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

QueryInfo

属性

  • disposition

    处置(可选)

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

  • tabId

    数字可选

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

  • text

    string

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

方法

query()

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

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

参数

  • queryInfo
  • callback

    函数(可选)

    callback 参数如下所示:

    ()=>void

返回

  • Promise<void>

    Chrome 96 及更高版本

    Manifest V3 及更高版本支持 promise,但提供回调以实现向后兼容性。您不能在同一个函数调用中同时使用这两者。promise 使用传递给回调函数的同一类型进行解析。