find.highlightResults()

Выделяет результаты предыдущего вызова find.find().

Когда расширение вызывает find(), совпадения не выделяются автоматически, но сохраняются браузером. Вызовите highlightResults(), чтобы выделить их.

Обратите внимание, что сохранённые результаты глобальны для всех расширений, поэтому, например, если расширение A вызывает find("apple"), а затем расширение B вызывает find("banana"), то если расширение A вызывает highlightResults(), результаты для "банана" будут выделены.

Синтаксис

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

Параметры

options Необязательно

object. Объект, задающий дополнительные параметры. Он может содержать любые из следующих свойств, все необязательные:

tabId: integer. Идентификатор вкладки для выделения. По умолчанию активная вкладка.
rangeIndex: integer. Индекс диапазона для выделения. По умолчанию выделяются все диапазоны.
noScroll: boolean. Не прокручивать к выделенному элементу. По умолчанию true.

Возвращаемое значение

None.

Совместимость с браузерами

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet
`highlightResults`	Нет	Нет	57	?	Нет	Нет	?	?	Нет	?	Нет	?

Примеры

Поиск в активной вкладке "банана", вывод количества совпадений и выделение:

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

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

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/find/highlightResults