toLowerCase

function toLowerCase(value: string, options: ToLowerCaseOptions = {}): string;

Отличие от String#toLowerCase — проверка и необязательный trim: пустое или нестроковое значение приводит к исключению, а не к сюрпризу дальше по коду.

Параметры

Параметр	Тип	Описание
`value`	`string`	Строка для преобразования. Не должна быть пустой.
`options` (необязательный) `= {}`	`ToLowerCaseOptions`	`trim` обрезает строку и схлопывает подряд идущие пробелы в один.

Возвращает

string — строка в нижнем регистре.

Исключения

Исключение	Условие
`EmptyStringException`	значение не строка или строка пуста.

Примеры

Преобразование

toLowerCase(" Hello World ", { trim: true }); // => "hello world"

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

Исходный код

src/lang/string/toLowerCase.ts

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.