String.prototype.length

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث

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

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

str.length

الوصف

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

حدَّد معيار ECMAScript 2016 (أي ES7) طولًا أقصى للعناصر وهو 253‎ - 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
الدعم الأساسي نعم نعم نعم نعم نعم

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