Window: find() Methode

Kein Standard: Diese Funktion ist nicht standardisiert und befindet sich nicht im Standardisierungsprozess. Verwenden Sie sie nicht auf Produktionsseiten, die auf das Web ausgerichtet sind: Sie wird nicht für alle Benutzer funktionieren. Außerdem kann es große Inkompatibilitäten zwischen Implementierungen geben und das Verhalten kann sich in Zukunft ändern.

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

BCD tables only load in the browser