requireEmpty

function requireEmpty<T>(
  value: T,
  message: string = "Expected an empty value.",
  strict: boolean = false
): T;

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

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

Параметры

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

Возвращает

T — то же значение, уже проверенное как пустое значение.

Исключения

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

Примеры

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

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

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

Исходный код

src/lang/base/requireEmpty.ts

23 September 2026

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