String.prototype.trimStart()

Метод trimStart() значений String удаляет пробельные символы из начала этой строки и возвращает новую строку, не изменяя исходную строку. trimLeft() является псевдонимом этого метода.

Попробовать

const greeting = "   Hello world!   ";

console.log(greeting);
// Expected output: "   Hello world!   ";

console.log(greeting.trimStart());
// Expected output: "Hello world!   ";

Синтаксис

trimStart()

trimLeft()

Параметры

Нет.

Возвращаемое значение

Новая строка, представляющая str с удалёнными пробельными символами из его начала (левой стороны). Пробельные символы определяются как символы пробела плюс терминаторы строк.

Если начало str не содержит пробельных символов, всё равно возвращается новая строка (по сути, копия str).

Псевдонимы

После того как trim() был стандартизирован, движки также реализовали нестандартный метод trimLeft. Однако для обеспечения согласованности с padStart(), когда метод был стандартизирован, его название было выбрано как trimStart. Из соображений веб-совместимости trimLeft остаётся псевдонимом для trimStart, и они ссылаются на один и тот же объект функции. В некоторых движках это означает:

String.prototype.trimLeft.name === "trimStart";

Примеры

Использование trimStart()

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

let str = "   foo  ";

console.log(str.length); // 8

str = str.trimStart();
console.log(str.length); // 5
console.log(str); // 'foo  '

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

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

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

• Полифил String.prototype.trimStart в core-js
• Полифил es-shims String.prototype.trimStart
• String.prototype.trim()
• String.prototype.trimEnd()