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' в этой спецификации.		 Стандарт  

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

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!
Возможность Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базовая поддержка (Да) (Да) (Да) (Да) (Да)
Возможность Android Chrome для Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базовая поддержка (Да) (Да) (Да) (Да) (Да) (Да)

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