apps-script-utils (Українська) 2.1.1 Help

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) на основі вихідного коду бібліотеки.