---
title: window.find
slug: Web/API/Window/find
translation_of: Web/API/Window/find
---
<p>{{ ApiRef() }}</p>
<p>{{ note(" <code>window.find()</code>可能会在未来版本的Gecko中被废弃 .  查看 Bug(672395) .") }}  </p>
<h3 id="Summary" name="Summary">概述</h3>
<p>在一个页面中搜索指定的字符串.</p>
<h3 id="Syntax" name="Syntax">语法</h3>
<pre class="eval"><em>window</em>.find(<em>aString</em>, <em>aCaseSensitive</em>, <em>aBackwards</em>, <em>aWrapAround</em>,
            <em>aWholeWord</em>, <em>aSearchInFrames</em>, <em>aShowDialog</em>);
</pre>
<dl>
 <dt>
  <code>aString</code></dt>
 <dd>
  将要搜索的字符串</dd>
 <dt>
  <code>aCaseSensitive</code></dt>
 <dd>
  布尔值,如果为<code>true</code>,表示搜索是区分大小写的.</dd>
 <dt>
  <code>aBackwards</code></dt>
 <dd>
  布尔值.如果为<code>true</code>, 表示搜索方向为向上搜索.</dd>
 <dt>
  <code>aWrapAround</code></dt>
 <dd>
  布尔值.如果为<code>true</code>, 表示为循环搜索.</dd>
 <dt>
  <code>aWholeWord</code> {{ unimplemented_inline() }}</dt>
 <dd>
  布尔值.如果为<code>true</code>,表示采用全字匹配搜索.该参数无效; 查看 {{ bug("481513") }}.</dd>
 <dt>
  <code>aSearchInFrames</code></dt>
 <dd>
  布尔值.如果为<code>true</code>, 表示会搜索框架内的文本.</dd>
 <dt>
  <code>aShowDialog</code></dt>
 <dd>
  布尔值.如果为<code>true</code>, 则会弹出一个搜索对话框.</dd>
</dl>
<h3 id="Returns" name="Returns">返回值</h3>
<p><code>如果搜索到指定的字符串,则返回true,否则</code>返回false.</p>
<h3 id="规范"><span style="font-weight: bold;">规范</span></h3>
<p>{{ DOM0() }}</p>