requireNonEmpty

function requireNonEmpty<T>(
  value: T,
  message: string = "Expected a non-empty value.",
  strict: boolean = false
): T;

Пустота понимается по типу: null и undefined, строка из одних пробелов, массив, Set или Map без элементов, объект без собственных ключей. 0 и false — это значения, а не пустота.

isX и nonX отвечают на вопрос и никогда не прерывают выполнение; requireX и requireNonX возвращают значение или выбрасывают исключение. Схема разобрана в Соглашения о проверках.

Параметры

Параметр	Тип	Описание
`value`	`T`	Значение, которое нужно проверить.
`message` (необязательный) `= "Expected a non-empty value."`	`string`	Сообщение исключения. Если не задано, используется сообщение по умолчанию.
`strict` (необязательный) `= false`	`boolean`	При `true` строка считается пустой, только если в ней вовсе нет символов; по умолчанию пробелы сначала отбрасываются.

Возвращает

T — то же значение; после проверки известно, что оно не является пустым значением.

Исключения

Исключение	Условие
`IllegalArgumentException`	значение является пустым значением.

Примеры

Что проходит, а что нет

requireNonEmpty(0); // => 0
requireNonEmpty(false); // => false
requireNonEmpty(null); // throws IllegalArgumentException
requireNonEmpty(""); // throws IllegalArgumentException

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

Исходный код

src/lang/base/requireNonEmpty.ts

23 September 2026

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