این آموزش در تاریخ ۱۴۰۰/۰۸/۰۴ آپدیت شده است.
آموزش متد includes در جاوااسکریپت
سلام خدمت تمامی دوستان و همراهان محترم سایت آموزشی فری لرن ، امیدوارم که حال همگیتون خوب باشه. لطفا در ادامه با آموزش متد includes در جاوااسکریپت با من همراه باشید.
Free-Learn
آنچه در این جلسه میخوانید :
متد includes در جاوااسکریپت
با استفاده از متد ()includes میتونیم بررسی کنیم ببینیم آیا یک متن ( که خودمون مشخص میکنیم ) درون یک متن دیگه قرار دارد یا نه!؟ یعنی کل متن رو جستجو میزنه و اگه متن مورد نظر وجود داشت true میده و در غیراینصورت false میده.
کلمه includes در لغت به فارسی یعنی ( شامل بودن ، دارا بودن یا در برداشتن )
| مقدار برگشتی | یک مقدار بولی ( Boolean ) برمیگرداند true : یعنی بله متن مورد نظر وجود داره یا false : یعنی خیر متن مورد نظر وجود نداره |
|---|---|
| نسخه | ECMAScript 6 |
Free-Learn
مثال از این متد
در ادامه میتوانید یک مثال از این متد را در زبان جاوا اسکریپت مشاهده نمایید.
مثال شماره ۱ : چک میکنه ببینه آیا کلمه Free در متن Salam Khobi? Free-Learn وجود دارد یا خیر.
|
1 2 3 4 5 6 7 |
<script> var MyText = "Salam Khobi? Free-Learn"; var result = document.getElementById("Result"); result.innerHTML = MyText.includes("Free"); </script> |
مثال شماره ۲ : جستجو زدن در متن فارسی
|
1 2 3 4 5 6 7 |
<script> var MyText = "سلام خوبی؟ فری لرن"; var result = document.getElementById("Result"); result.innerHTML = MyText.includes("فری"); </script> |
مثال شماره ۳ : یک متن از کاربر میگیره و در متن مورد نظر جستجو میزنه
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
<script> function Search(){ var Text = document.getElementById("MyText").innerHTML; var result = document.getElementById("Result"); var user_input = document.getElementById("UserInput").value; if( user_input == "" ){ alert("دیگه اذیت نکن، یه چیزی وارد کن"); }else{ var Check = Text.includes(user_input); if( Check == true ){ result.innerHTML = "متن " + user_input + " یافت شد "; }else{ result.innerHTML = "متن " + user_input + " یافت نشد "; } } } </script> |
Free-Learn
پشتیبانی مرورگرها
در جدول زیر میتوانید مشاهده نمایید که آیا مرورگرهای اینترنتی از این متد در جاوااسکریپت پشتیبانی میکنند یا خیر.
| نام متد | Chrome | Firefox | Opera | Safari | IE |
| ()includes | ۴۱ | ۴۰ | ۳۶ | ۹ | خیر |
Free-Learn
شکل نوشتاری
نحوه نوشتن یا استفاده یا سینتَکس (Syntax) این متد در جاوااسکریپت بصورت زیر می باشد.
|
1 |
String.includes( "Search_Value" , Start_Index ); |
Free-Learn
جدول پارامترها
در جدول زیر میتوانید، پارامترهایی را که میتوان در این متد استفاده کرد مشاهده نمایید.
| مقدار | توضیح |
|---|---|
| Search_Value | ضروری – اون متنی که قراره در متن اصلی جستجو زده بشه |
| Start_Index | اختیاری – جایگاه شروع جستجو ( جایگاه یا شماره ایندکس ) مقدار پیش فرض : ۰ |
Free-Learn
موارد استفاده این متد
از این متد میتوان در بخش های زیر استفاده کرد. ( یعنی کاربرد این متد در موارد زیر می باشد )
| رشته ها ( String ) | آرایه ها ( Array ) |
Free-Learn
نکات و توضیحات
- این متد در مرورگر اینترنت اکسپلورر یا Internet Explorer پشتیبانی نمیشود.
- این متد به حروف کوچک و بزرگ انگلیسی حساس می باشد، یعنی اگه متن Salam بود و شما خواستید s رو جستجو بزنید بهتون false میده چون s کوچک دادید.
- این متد جستجو رو در کل متن میزنه ( متن های انگلیسی از سمت چپ به راست و متن های فارسی از سمت راست به چپ )
- پارامتر دوم ( اونکه شماره ایندکس رو مشخص میکنه ) اختیاری می باشد ، ولی خب اگه بخواید استفاده کنید باید شماره جایگاه اولین حرف از متن رو بر اساس شماره ایندکس ( که یعنی جستجو از اونجا شروع بشه ) مشخص کنید.
