find.highlightResults()

突出显示之前对 find.find() 的调用的结果。

当扩展调用 find() 时,匹配项不会自动突出显示,但它们会被浏览器存储。调用 highlightResults() 来突出显示它们。

请注意,存储的结果在所有扩展中都是全局的,例如,如果扩展 A 调用 find("apple"),然后扩展 B 调用 find("banana"),然后如果扩展 A 调用 highlightResults(),则将突出显示“banana”的结果。

语法

js
browser.find.highlightResults(
  options // optional object
)

参数

options 可选

object. 一个指定其他选项的对象。它可以采用以下任何属性,所有属性都是可选的

tabId

integer. 要突出显示的标签的 ID。默认为活动标签。

rangeIndex

integer. 要突出显示的范围的索引。默认为突出显示所有范围。

noScroll

boolean. 不要滚动到突出显示的项目。默认为 true

返回值

无。

浏览器兼容性

BCD 表格仅在浏览器中加载

示例

在活动标签中搜索“banana”,记录匹配项的数量,并突出显示它们

js
function found(results) {
  console.log(`There were: ${results.count} matches.`);
  if (results.count > 0) {
    browser.find.highlightResults();
  }
}

browser.find.find("banana").then(found);