string.length

Определение и применение

Свойство length строки возвращает количество кодовых единиц UTF-16 — частей, из которых JavaScript хранит текст. Оно помогает проверить пустую строку, ограничить длину ввода или найти последний индекс. Для обычных русских букв каждая буква занимает одну такую единицу, а некоторые символы занимают больше.

Индексы и неизменяемость текста разобраны в уроке «Строки».

Поддержка браузерами

Спецификация: ecma262

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьjavascript.builtins.String.length
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
length✓1✓12✓1✓3✓1✓18✓4✓10.1✓1✓1.0✓4.4✓1

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

Синтаксис и значение

JavaScript
text.length;

text — переменная со строкой, например "Мяч". Скобки после length не нужны: это свойство, а не метод. Результат — неотрицательное целое число типа number. У пустой строки длина равна нулю. Пробелы и переводы строк тоже учитываются.

Длина и видимые символы

"😀".length равно 2. Даже подсчёт кодовых точек через [...text].length не всегда совпадает с количеством видимых символов: буква и отдельный знак ударения могут отображаться вместе. Для подсчёта пользовательских символов применяют сегментацию на графемы, например Intl.Segmenter, с проверкой поддержки в целевых браузерах. Пример Unicode показывает различие, не требуя этого API.

Проверка текста

Проверка text.length > 0 принимает строку из пробелов. Если задача требует содержательного текста, сначала получите строку без крайних пробелов через trim(). Правила допустимой длины выбирайте явно: лимит хранилища и число видимых символов могут измеряться по-разному.

У null и undefined нельзя читать свойства. Сначала убедитесь, что значение является строкой, как в примере проверки ввода. Отсутствующее значение не следует автоматически считать строкой нулевой длины.

Почему длину нельзя присвоить

Строки неизменяемы. Присваивание text.length = 1 не сокращает текст, а в строгом режиме вызывает TypeError. Чтобы получить другой текст, используйте строковый метод и сохраните его результат. У строкового объекта length — собственное неперечисляемое, неизменяемое и неудаляемое свойство.

Отличайте text.length от String.length. Второе значение равно 1 и описывает число объявленных параметров функции String, а не длину вашего текста.

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

ECMAScript: свойства строковых объектов, length.

Примеры, попробуйте сами

Пустая строка и строка из пробелов

В text находятся три пробела. До trim длина равна 3, после — 0. Замените пробелы на название товара, затем замените text целиком на null и проверьте безопасное условие.

index.html
HTML
<!doctype html><html lang="ru"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Пустая строка и строка из пробелов</title></head><body><p>Откройте консоль браузера, чтобы увидеть результат.</p><script src="main.js"></script></body></html>
main.js
JavaScript
const text = "   ";
console.log(typeof text === "string" && text.length > 0);
console.log(typeof text === "string" && text.trim().length > 0);
console.log("Мяч".length, "".length);

Кодовые единицы и кодовые точки

Сравните обычное слово, эмодзи и букву с отдельным знаком ударения. У эмодзи две кодовые единицы, но одна кодовая точка. У последней строки две точки, хотя она выглядит как одна буква с ударением.

index.html
HTML
<!doctype html><html lang="ru"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Кодовые единицы и кодовые точки</title></head><body><p>Откройте консоль браузера, чтобы увидеть результат.</p><script src="main.js"></script></body></html>
main.js
JavaScript
const word = "Мяч";
const emoji = "😀";
const accented = "е́";
console.log(word.length, [...word].length);
console.log(emoji.length, [...emoji].length);
console.log(accented.length, [...accented].length);