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);