---
title: RegExp.prototype.test()
slug: Web/JavaScript/Reference/Global_Objects/RegExp/test
tags:
  - جاوا اسکریپت
  - جستجو
  - متد
translation_of: Web/JavaScript/Reference/Global_Objects/RegExp/test
---
<div dir="rtl">
 {{JSRef("Global_Objects", "RegExp")}}</div>
<h2 dir="rtl" id="Summary" name="Summary">خلاصه</h2>
<p dir="rtl"><strong>متد test یک جستجو برای یافتن رشته خاص در متن یا رشته مورد نظر انجام میدهد و True یا False برمیگرداند.</strong></p>
<h2 dir="rtl" id="Syntax" name="Syntax">ساختار</h2>
<pre dir="rtl"><var>regexObj</var>.test(str)</pre>
<h3 dir="rtl" id="Parameters" name="Parameters"><strong>پارامتر ها</strong></h3>
<dl>
 <dt dir="rtl">
  <code>str</code></dt>
 <dd dir="rtl">
  <strong>رشته ای که میخواهید با متن مورد نظر تطابق دهید.</strong></dd>
</dl>
<h3 dir="rtl" id="مقدار_بازگشتی"><strong>مقدار بازگشتی</strong></h3>
<p dir="rtl"><strong>مقدار بازگشتی از نوع Boolean بوده و True یا False میباشد.</strong></p>
<h2 dir="rtl" id="Description" name="Description">توضیحات</h2>
<p dir="rtl"><strong>متد test() زمانی استفاده میشود که میخواهید الگو مورد نظر خود را در یک متن جستجو کنید و از وجود آن در متن مورد نظر با خبر شوید.</strong></p>
<p dir="rtl"><strong>متدهای مرتبط :</strong> {jsxref("String.search") , {jsxref("RegExp.exec", "exec")</p>
<h2 dir="rtl" id="Examples" name="Examples">مثال</h2>
<h3 dir="rtl" id="Example:_Using_test" name="Example:_Using_test"><code>مثال: استفاده از test</code></h3>
<p dir="rtl"><strong>مثال زیر یک خروجی را چاپ میکند که اشاره به موفقیت آمیز بودن جستجو دارد:</strong></p>
<pre class="brush: js" dir="rtl">function testinput(re, str){
    var midstring;
    if (re.test(str)) {
        midstring = " contains ";
    } else {
        midstring = " does not contain ";
    }
    console.log(str + midstring + re.source);
}
</pre>
<h2 dir="rtl" id="خصوصیات">خصوصیات</h2>
<table class="standard-table" dir="rtl">
 <tbody>
  <tr>
   <th scope="col">خصوصیت</th>
   <th scope="col">وضعیت</th>
   <th scope="col">یاداشت</th>
  </tr>
  <tr>
   <td>ECMAScript 3rd Edition. Implemented in JavaScript 1.2</td>
   <td>Standard</td>
   <td>Initial definition.</td>
  </tr>
  <tr>
   <td>{{SpecName('ES5.1', '#sec-15.10.6.3', 'RegExp.test')}}</td>
   <td>{{Spec2('ES5.1')}}</td>
   <td> </td>
  </tr>
  <tr>
   <td>{{SpecName('ES6', '#sec-regexp.prototype.test', 'RegExp.test')}}</td>
   <td>{{Spec2('ES6')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>
<h2 dir="rtl" id="سازگاری_با_مرورگرها">سازگاری با مرورگرها</h2>
<p dir="rtl">{{ CompatibilityTable() }}</p>
<div dir="rtl" id="compat-desktop">
 <table class="compat-table">
  <tbody>
   <tr>
    <th>خصوصیات</th>
    <th>گوگل کروم</th>
    <th>فایرفاکس</th>
    <th>اینترنت اکسپلورر</th>
    <th>اپرا</th>
    <th>سافاری</th>
   </tr>
   <tr>
    <td>پشتیبانی ابتدایی</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
   </tr>
  </tbody>
 </table>
</div>
<div dir="rtl" id="compat-mobile">
 <table class="compat-table">
  <tbody>
   <tr>
    <th>خصوصیات</th>
    <th>اندروید</th>
    <th>گوگل کروم برای اندروید</th>
    <th>فایرفاکس موبایل</th>
    <th>اینترنت اکسپلورر موبایل</th>
    <th>اپرا موبایل</th>
    <th>سافاری موبایل</th>
   </tr>
   <tr>
    <td>پشتیبانی ابتدایی</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatVersionUnknown() }}</td>
   </tr>
  </tbody>
 </table>
</div>
<h3 dir="rtl" id="sect1"> </h3>
<h3 dir="rtl" id="یادداشتی_برای_Gecko-specific"><strong>یادداشتی برای Gecko-specific</strong></h3>
<p dir="rtl"><strong>قبل از نسخه Gecko 8.0 {{ geckoRelease("8.0") }} تابع test() مشکلاتی به همراه داشت ، زمانی که این تابع بدون پارامتر ورودی فراخوانی میشد الگو را با متن قبلی مطابقت میداد (RegExp.input property) در حالی که بایستی رشته "undefined" را قرار میداد. در حال حاضر این مشکل برطرف شده است و <code>این تابع به درستی کار میکند.</code></strong></p>
<p dir="rtl"> </p>
<p dir="rtl"> </p>
<h2 dir="rtl" id="همچنین_سری_بزنید_به">همچنین سری بزنید به :</h2>
<ul dir="rtl">
 <li><a href="/en-US/docs/Web/JavaScript/Guide/Regular_Expressions" title="JavaScript/Guide/Regular_Expressions">Regular Expressions</a> chapter in the <a href="/en-US/docs/Web/JavaScript/Guide" title="JavaScript/Guide">JavaScript Guide</a></li>
 <li>{{jsxref("Global_Objects/RegExp", "RegExp")}}</li>
</ul>