requireLength

function requireLength(
  value: unknown,
  message: string = "Expected a valid array-like length."
): number;

Ціле число від 0 до Number.MAX_SAFE_INTEGER — діапазон, який може містити властивість length.

isX та nonX відповідають на питання й ніколи не переривають виконання; requireX і requireNonX повертають значення або викидають виняток. Схему розібрано в Домовленості про перевірки.

Параметри

Параметр	Тип	Опис
`value`	`unknown`	Значення, яке потрібно перевірити.
`message` (необов'язковий) `= "Expected a valid array-like length."`	`string`	Повідомлення винятку. Якщо не задано, використовується типове повідомлення.

Повертає

number — те саме значення, вже перевірене як припустиму довжину масиву.

Винятки

Виняток	Умова
`IllegalArgumentException`	значення не є припустимою довжиною масиву.

Приклади

Що проходить, а що ні

requireLength(0); // => 0
requireLength(42); // => 42
requireLength(-1); // throws IllegalArgumentException
requireLength(1.5); // throws IllegalArgumentException

Дивіться також

Вихідний код

src/lang/base/requireLength.ts

23 September 2026

Цю документацію згенеровано нейромережею (Claude) на основі вихідного коду бібліотеки.