String.length

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Сводка

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

Синтаксис

str.length

Описание

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

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

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

Примеры

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

js
var x = "Mozilla";
var empty = "";

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

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

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

Specification
ECMAScript Language Specification
# sec-properties-of-string-instances-length

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

BCD tables only load in the browser

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