Window: find() 方法

非标准：此功能是非标准的，并且不在标准轨道上。不要在面向 Web 的生产网站上使用它：它不会对每个用户都起作用。实现之间也可能存在很大的不兼容性，并且行为将来可能会发生变化。

注意：Window.find() 的支持可能会在未来版本的 Gecko 中发生变化。请参阅 Firefox 错误 672395。

Window.find() 方法按顺序在窗口中查找字符串。

语法

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

参数

aString: 要搜索的文本字符串。
aCaseSensitive: 布尔值。如果为 true，则指定区分大小写的搜索。
aBackwards: 布尔值。如果为 true，则指定反向搜索。
aWrapAround: 布尔值。如果为 true，则指定循环搜索。
aWholeWord: 布尔值。如果为 true，则指定整词搜索。
aSearchInFrames: 布尔值。如果为 true，则指定在框架中搜索。
aShowDialog: 布尔值。如果为 true，则显示搜索对话框。

返回值

如果找到字符串，则返回 true；否则返回 false。

示例

JavaScript

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>

结果

注释

在某些浏览器中，Window.find() 会选择（突出显示）网站上找到的内容。

规范

这不是任何规范的一部分。

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。