String.prototype.length

الخاصية length التابعة لكائنات String تُشير إلى طول السلسلة النصية، وذلك بعدّ عدد رموز UTF-16.

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

str.length

الوصف

هذه الخاصية تُعيد عدد رموز المحارف (code points) الموجودة في السلسلة النصية. لاحظ أنَّ ترميز UTF-16 هو الصيغة المستخدم في JavaScript، وهو يستخدم 16-بت لتمثيل المحارف الشائعة، لكنه يحتاج إلى أكثر من بايت لتمثيل المحارف الأقل شيوعًا، لذا من الممكن ألّا تساوي القيمة المُعادة من الخاصية length عدد المحارف الفعلية الموجودة في السلسلة النصية.

حدَّد معيار ECMAScript 2016 (أي ES7) طولًا أقصى للعناصر وهو 2^53‎ - 1، لكن لم يكن هنالك حدٌ أقصى فيما قد سلف.

قيمة الخاصية length للسلاسل النصية الفارغة هو 0، بينما قيمة الخاصية الساكنة (static property) التابعة للكائن String (أي String.length) هي 1.

أمثلة

المثال الآتي يُبيّن استخدام الخاصية length:

var x = 'Hsoub';
var y = "حسوب";
var empty = '';

console.log('Hsoub is ' + x.length + ' code units long');
// "Hsoub is 5 code units long"

console.log('حسوب is ' + y.length + ' code units long');
// "حسوب is 4 code units long"

console.log('The empty string has a length of ' + empty.length);
// "The empty string has a length of 0"

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

الميزة	Chrome	Firefox	Internet Explorer	Opera	Safari
الدعم الأساسي	نعم	نعم	نعم	نعم	نعم

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

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