JavaScript/String/startsWith

الدالة String.prototype.startsWith()‎ تُحدِّد إن كانت تبدأ سلسلةٌ نصيةٌ بمحارف سلسلةٍ نصيةٍ أخرى، وتُعيد القيمة true أو false.

البنية العامة

str.startsWith(searchString[, position])

searchString

السلسلة النصية التي سيُبحَث عنها في بداية السلسلة النصية الأصلية.

length

قيمة اختيارية، وإذا حُدِّدَت فستتجاوز طول (length) السلسلة النصية التي سيُبحَث فيها، وإذا حُذِفَت فستكون القيمة الافتراضية مساويةً لطول السلسلة النصية. انظر الأمثلة.

القيمة المعادة

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

الوصف

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

حالة الأحرف

الدالة startsWith()‎ حساسةٌ لحالة الأحرف، أي أنَّ التعبير البرمجي الآتي سيُعيد القيمة false:

'Blue Whale'.startsWith('bl'); // false

أمثلة

المثال الآتي يستخدم الدالة startsWith()‎ للتحقق من بداية السلسلة النصية الأصلية:

var str = 'To be, or not to be, that is the question.';

console.log(str.startsWith('To be'));         // true
console.log(str.startsWith('not to be'));     // false
console.log(str.startsWith('not to be', 10)); // true

تعويض نقص دعم المتصفحات

أُضيفَت هذه الدالة إلى معيار ECMAScript 2015، وقد لا تتوافر في جميع المتصفحات بعد، لكن يمكنك استخدام الشيفرة الآتية لتعريفها في المتصفحات التي لا تدعمها:

if (!String.prototype.startsWith) {
  String.prototype.startsWith = function(search, pos) {
    return this.substr(!pos || pos < 0 ? 0 : +pos, search.length) === search;
  };
}

دعم المتصفحات

الميزة	Chrome	Firefox	Internet Explorer	Opera	Safari
الدعم الأساسي	41	17	غير مدعومة	28	9

على النقيض من متصفح IE، يدعم متصفح Edge هذه الميزة.

مصادر ومواصفات

• مسودة المعيار ECMAScript Latest Draft.
• معيار ECMAScript 2015 (6th Edition)‎.