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

requireNumberLike

function requireNumberLike( value: unknown, message: string = "Expected a numeric value." ): number | string;

Un nombre fini, ou une chaîne qui se convertit en un nombre fini. NaN, les infinis et la chaîne vide sont exclus, ce qui distingue ce test d'un simple Number(value).

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

unknown

La valeur à valider.

message (facultatif) = "Expected a numeric value."

string

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

Valeur de retour

number | string — la même valeur, typée comme une valeur numérique.

Exceptions

Exception

Condition

IllegalArgumentException

la valeur n'est pas convertible en nombre.

Exemples

Ce qui passe et ce qui ne passe pas

requireNumberLike(1); // => 1 requireNumberLike("1.5"); // => "1.5" requireNumberLike(NaN); // throws IllegalArgumentException requireNumberLike(Infinity); // throws IllegalArgumentException

Voir aussi

Code source

src/lang/base/requireNumberLike.ts

23 September 2026

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