عرض مصدر JavaScript/String/endsWith

<noinclude>{{DISPLAYTITLE:<code>String.prototype.endsWith()‎</code>}}</noinclude>
الدالة <code>String.prototype.endsWith()‎</code> تُحدِّد إن كانت تنتهي سلسلةٌ نصيةٌ بمحارف سلسلةٍ نصيةٍ أخرى، وتُعيد القيمة <code>true</code> أو <code>false</code>.
==البنية العامة==
<syntaxhighlight lang="javascript">
str.endsWith(searchString[, length])

</syntaxhighlight>
=== <code>searchString</code> ===
السلسلة النصية التي سيُبحَث عنها في نهاية السلسلة النصية الأصلية.

=== <code>length</code> ===
قيمة اختيارية، وإذا حُدِّدَت فستتجاوز طول (<code>[[JavaScript/String/length|length]]</code>) السلسلة النصية التي سيُبحَث فيها، وإذا حُذِفَت فستكون القيمة الافتراضية مساويةً لطول السلسلة النصية. انظر [[#أمثلة|الأمثلة]].

=== القيمة المعادة ===
القيمة <code>true</code> إذا عُثِرَ على السلسلة النصية <code>searchString</code> في نهاية السلسلة النصية الأصلية، وإلا فستُعاد القيمة <code>false</code>.

== الوصف ==
هذه الدالة تسمح لنا بمعرفة إن كانت تنتهي سلسلةٌ نصيةٌ بمحارف سلسلةٍ نصيةٍ أخرى.

=== حالة الأحرف ===
الدالة <code>endsWith()‎</code> حساسةٌ لحالة الأحرف، أي أنَّ التعبير البرمجي الآتي سيُعيد القيمة <code>false</code>:<syntaxhighlight lang="javascript">
'Blue Whale'.endsWith('lE'); // false
</syntaxhighlight>

== أمثلة ==
المثال الآتي يستخدم الدالة <code>endsWith()‎</code> للتحقق من نهاية السلسلة النصية الأصلية:<syntaxhighlight lang="javascript">
var str = 'To be, or not to be, that is the question.';

console.log(str.endsWith('question.')); // true
console.log(str.endsWith('to be'));     // false
console.log(str.endsWith('to be', 19)); // true

</syntaxhighlight>

== تعويض نقص دعم المتصفحات ==
أُضيفَت هذه الدالة إلى معيار ECMAScript 2015، وقد لا تتوافر في جميع المتصفحات بعد، لكن يمكنك استخدام الشيفرة الآتية لتعريفها في المتصفحات التي لا تدعمها:<syntaxhighlight lang="javascript">
if (!String.prototype.endsWith) {
  String.prototype.endsWith = function(search, this_len) {
    if (this_len === undefined || this_len > this.length) {
      this_len = this.length;
    }
    return this.substring(this_len - search.length, this_len) === search;
  };
}

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|41
|17
|غير مدعومة
|28
|9
|}
على النقيض من متصفح IE، يدعم متصفح Edge هذه الميزة.

== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-string.prototype.endswith ECMAScript Latest Draft].
* معيار [https://www.ecma-international.org/ecma-262/6.0/#sec-string.prototype.endswith ECMAScript 2015 (6th Edition)]‎. 
[[تصنيف:JavaScript]]
[[تصنيف:JavaScript Global Objects]]
[[تصنيف:JavaScript String]]