apps-script-utils (Français) 2.1.1 Help

requireNonScalar

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

Une primitive porteuse d'une seule valeur : chaîne, nombre, booléen, symbole ou bigint. null et undefined sont primitifs aussi, mais ne portent aucune valeur et ne comptent pas.

isX et nonX répondent à une question sans jamais interrompre le flot ; requireX et requireNonX rendent la valeur ou lèvent. Le schéma est expliqué dans Conventions de validation.

Paramètres

Paramètre

Type

Description

value

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

La valeur à valider.

message (facultatif) = "Expected a non-scalar value."

string

Le message de l'exception. À défaut, un message par défaut est utilisé.

Valeur de retour

T — la même valeur ; après le test, elle n'est pas un scalaire.

Exceptions

Exception

Condition

IllegalArgumentException

la valeur est un scalaire.

Exemples

Ce qui passe et ce qui ne passe pas

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

Voir aussi

Code source

src/lang/base/requireNonScalar.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.