خلاصه
متد test یک جستجو برای یافتن رشته خاص در متن یا رشته مورد نظر انجام میدهد و True یا False برمیگرداند.
ساختار
regexObj.test(str)
پارامتر ها
-
str - رشته ای که میخواهید با متن مورد نظر تطابق دهید.
مقدار بازگشتی
مقدار بازگشتی از نوع Boolean بوده و True یا False میباشد.
توضیحات
متد test() زمانی استفاده میشود که میخواهید الگو مورد نظر خود را در یک متن جستجو کنید و از وجود آن در متن مورد نظر با خبر شوید.
متدهای مرتبط : {jsxref("String.search") , {jsxref("RegExp.exec", "exec")
مثال
مثال: استفاده از test
مثال زیر یک خروجی را چاپ میکند که اشاره به موفقیت آمیز بودن جستجو دارد:
function testinput(re, str){
var midstring;
if (re.test(str)) {
midstring = " contains ";
} else {
midstring = " does not contain ";
}
console.log(str + midstring + re.source);
}
خصوصیات
| خصوصیت | وضعیت | یاداشت |
|---|---|---|
| ECMAScript 3rd Edition. Implemented in JavaScript 1.2 | Standard | Initial definition. |
| ECMAScript 5.1 (ECMA-262) The definition of 'RegExp.test' in that specification. |
Standard | |
| ECMAScript 6 (ECMA-262) The definition of 'RegExp.test' in that specification. |
Release Candidate |
سازگاری با مرورگرها
| خصوصیات | گوگل کروم | فایرفاکس | اینترنت اکسپلورر | اپرا | سافاری |
|---|---|---|---|---|---|
| پشتیبانی ابتدایی | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
| خصوصیات | اندروید | گوگل کروم برای اندروید | فایرفاکس موبایل | اینترنت اکسپلورر موبایل | اپرا موبایل | سافاری موبایل |
|---|---|---|---|---|---|---|
| پشتیبانی ابتدایی | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
یادداشتی برای Gecko-specific
قبل از نسخه Gecko 8.0 (Firefox 8.0 / Thunderbird 8.0 / SeaMonkey 2.5) تابع test() مشکلاتی به همراه داشت ، زمانی که این تابع بدون پارامتر ورودی فراخوانی میشد الگو را با متن قبلی مطابقت میداد (RegExp.input property) در حالی که بایستی رشته "undefined" را قرار میداد. در حال حاضر این مشکل برطرف شده است و این تابع به درستی کار میکند.
همچنین سری بزنید به :
- Regular Expressions chapter in the JavaScript Guide
RegExp