Window: find() Methode

Nicht standardisiert: Diese Funktion ist nicht standardisiert und befindet sich nicht auf dem Weg zur Standardisierung. Verwenden Sie sie nicht auf Produktionsseiten, die dem Web ausgesetzt sind: Sie funktioniert nicht für alle Benutzer. Es kann auch 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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
find
Non-standard

Legend

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

Full support
Full support
Non-standard. Check cross-browser support before using.