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

返回值

无。

示例

在当前标签页中搜索“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);

浏览器兼容性