String.prototype.length
< JavaScript | String
اذهب إلى التنقل
اذهب إلى البحث
الخاصية 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 |
---|---|---|---|---|---|
الدعم الأساسي | نعم | نعم | نعم | نعم | نعم |
مصادر ومواصفات
- مسودة المعيار ECMAScript Latest Draft.
- معيار ECMAScript 2015 (6th Edition).
- معيار ECMAScript 5.1.
- معيار ECMAScript 1st Edition .