find.highlightResults()

Hebt die Ergebnisse eines vorherigen Aufrufs von find.find() hervor.

Wenn eine Erweiterung find() aufruft, werden die Treffer nicht automatisch hervorgehoben, aber sie werden vom Browser gespeichert. Rufen Sie highlightResults() auf, um sie hervorzuheben.

Beachten Sie, dass die gespeicherten Ergebnisse global über alle Erweiterungen hinweg sind. Wenn beispielsweise Erweiterung A find("apple") aufruft und anschließend Erweiterung B find("banana"), dann würde ein Aufruf von highlightResults() durch Erweiterung A die Ergebnisse für "banana" hervorheben.

Syntax

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

Parameter

options Optional

object. Ein Objekt, das zusätzliche Optionen spezifiziert. Es kann die folgenden Eigenschaften enthalten, die alle optional sind:

tabId

integer. ID des Tabs, der hervorgehoben werden soll. Standardmäßig der aktive Tab.

rangeIndex

integer. Index des Bereichs, der hervorgehoben werden soll. Standardmäßig werden alle Bereiche hervorgehoben.

noScroll

boolean. Nicht zum hervorgehobenen Element scrollen. Standardmäßig true.

Rückgabewert

Keiner.

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
highlightResults

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Beispiele

Durchsuchen Sie den aktiven Tab nach "banana", protokollieren Sie die Anzahl der Treffer und heben Sie sie hervor:

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

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