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

isEmpty

function isEmpty(value: unknown, strict: boolean = false): boolean;

La vacuité se lit selon le type : null et undefined, une chaîne faite d'espaces, un tableau, Set ou Map sans entrée, un objet sans clé propre. 0 et false sont des valeurs, pas du vide.

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 à vérifier.

strict (facultatif) = false

boolean

The strictness mode for string validation. - If false (default), strings containing only whitespace characters (spaces, tabs, newlines) are considered empty (using trim()). This is known as "blank" check. - If true, only a string with zero length ("") is considered empty.

Valeur de retour

boolean — true si la valeur est vide ; sinon false.

Exemples

Ce qui passe et ce qui ne passe pas

isEmpty(null); // => true isEmpty(""); // => true isEmpty(" "); // => true isEmpty([]); // => true isEmpty({}); // => true isEmpty(new Map()); // => true isEmpty(0); // => false isEmpty(false); // => false isEmpty("a"); // => false isEmpty([0]); // => false

Voir aussi

Code source

src/lang/base/isEmpty.ts

23 September 2026

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