Window: find() Methode

Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

Hinweis: Die Unterstützung für Window.find() könnte sich in zukünftigen Versionen von Gecko ändern. Siehe Firefox-Bug 672395.

Die Window.find()-Methode findet eine Zeichenkette sequenziell in einem Fenster.

Syntax

js
find(aString, aCaseSensitive, aBackwards, aWrapAround, aWholeWord, aSearchInFrames, aShowDialog)

Parameter

aString

Die zu suchende Textzeichenkette.

aCaseSensitive

Ein boolescher Wert. Wenn true, wird eine groß-/kleinschreibungssensitive Suche durchgeführt.

aBackwards

Ein boolescher Wert. Wenn true, wird eine Rückwärtssuche durchgeführt.

aWrapAround

Ein boolescher Wert. Wenn true, wird eine umschließende Suche durchgeführt.

aWholeWord

Ein boolescher Wert. Wenn true, wird eine Suche nach ganzen Wörtern durchgeführt.

aSearchInFrames

Ein boolescher Wert. Wenn true, wird in Frames gesucht.

aShowDialog

Ein boolescher Wert. Wenn true, wird ein Suchdialog angezeigt.

Rückgabewert

true, wenn die Zeichenkette gefunden wird; andernfalls false.

Beispiele

JavaScript

js
function findString(text) {
  document.querySelector("#output").textContent = `String found? ${window.find(
    text,
  )}`;
}

HTML

html
<p>Apples, Bananas, and Oranges.</p>
<button type="button" onClick='findString("Apples")'>Search for Apples</button>
<button type="button" onClick='findString("Bananas")'>
  Search for Bananas
</button>
<button type="button" onClick='findString("Orange")'>Search for Orange</button>

<p id="output"></p>

Ergebnis

Hinweise

In einigen Browsern markiert (hervorhebt) Window.find() den gefundenen Inhalt auf der Seite.

Spezifikationen

Dies ist nicht Teil einer Spezifikation.

Browser-Kompatibilität