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

requireNonScalar

function requireNonScalar<T>( value: T | string | number | boolean | symbol | bigint, message: string = "Expected a non-scalar value." ): T;

Примітив, що несе одне значення: рядок, число, логічне значення, символ або bigint. null і undefined теж примітиви, але значення не несуть і не підходять.

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

Параметри

Параметр

Тип

Опис

value

T \| string \| number \| boolean \| symbol \| bigint

Значення, яке потрібно перевірити.

message (необов'язковий) = "Expected a non-scalar value."

string

Повідомлення винятку. Якщо не задано, використовується типове повідомлення.

Повертає

T — те саме значення; після перевірки відомо, що воно не є скалярним значенням.

Винятки

Виняток

Умова

IllegalArgumentException

значення є скалярним значенням.

Приклади

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

requireNonScalar({}); // => {} requireNonScalar([]); // => [] requireNonScalar("abc"); // throws IllegalArgumentException requireNonScalar(1); // throws IllegalArgumentException

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

Вихідний код

src/lang/base/requireNonScalar.ts

23 September 2026

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