Window：find() 方法

非标准: 该特性尚未标准化。我们不建议在生产环境中使用非标准特性，因为它们在浏览器中的支持有限，且可能发生变化或被移除。不过，在没有标准选项的特定情况下，它们可以作为合适的替代方案。

备注： 未来版本的 Gecko 对 Window.find() 的支持可能会发生变化。参见 Firefox bug 672395。

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

语法

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

参数

aString: 将要搜索的文本字符串。
aCaseSensitive: 布尔值，如果为 true，表示区分大小写搜索。
aBackwards: 布尔值。如果为 true，表示从后往前搜索。
aWrapAround: 布尔值。如果为 true，表示循环搜索。
aWholeWord: 布尔值。如果为 true，表示全词搜索。
aSearchInFrames: 布尔值。如果为 true，表示在框架（frame）中搜索。
aShowDialog: 布尔值。如果为 true，则会弹出一个搜索对话框。

返回值

如果找到指定的字符串，则返回 true，否则返回 false。

示例

JavaScript

function findString(text) {
  document.querySelector("#output").textContent = `找到了字符串？${window.find(
    text,
  )}`;
}

HTML

html

<p>苹果、香蕉和橙子。</p>
<button type="button" onClick='findString("苹果")'>搜索苹果</button>
<button type="button" onClick='findString("香蕉")'>搜索香蕉</button>
<button type="button" onClick='findString("橙子")'>搜索橙子</button>

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

结果

备注

在某些浏览器中，Window.find() 会选择（高亮）找到的内容。

规范

不属于任何规范。