String.length

Сводка

Свойство length представляет длину строки.

Синтаксис

str.length

Описание

Это свойство возвращает количество кодовых значений в строке. В UTF-16, строковом формате, используемом в JavaScript, для представления большинства символов используется одно 16-битное кодовое значение, но для представления не так часто используемых символов требуется два кодовых значения, так что вполне может быть так, что значение, возвращённое свойством length не будет соответствовать действительному количеству символов в строке.

Для пустых строк свойство length возвращает 0.

Статическое свойство String.length возвращает значение 1.

Примеры

Пример: базовое использование

var x = 'Mozilla';
var empty = '';

console.log('Слово «Mozilla» занимает ' + x.length + ' кодовых значений');
/* "Слово «Mozilla» занимает 7 кодовых значений" */

console.log('Пустая строка имеет длину, равную ' + empty.length);
/* "Пустая строка имеет длину, равную 0" */

Спецификации

Спецификация Статус Комментарии
ECMAScript 1-е издание. Стандарт Изначальное определение. Реализована в JavaScript 1.0.
ECMAScript 5.1 (ECMA-262)
Определение 'String.prototype.length' в этой спецификации.
Стандарт  
ECMAScript 2015 (6th Edition, ECMA-262)
Определение 'String.prototype.length' в этой спецификации.
Стандарт  

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также