requireEmpty

function requireEmpty<T>(
  value: T,
  message: string = "Expected an empty value.",
  strict: boolean = false
): T;

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`	`T`	La valeur à valider.
`message` (facultatif) `= "Expected an empty value."`	`string`	Le message de l'exception. À défaut, un message par défaut est utilisé.
`strict` (facultatif) `= false`	`boolean`	Avec `true`, une chaîne n'est vide que si elle ne contient aucun caractère ; par défaut, les espaces sont retirés d'abord.

Valeur de retour

T — la même valeur, typée comme une valeur vide.

Exceptions

Exception	Condition
`IllegalArgumentException`	la valeur n'est pas vide.

Exemples

Ce qui passe et ce qui ne passe pas

requireEmpty(null); // => null
requireEmpty(""); // => ""
requireEmpty(0); // throws IllegalArgumentException
requireEmpty(false); // throws IllegalArgumentException

Voir aussi

Code source

src/lang/base/requireEmpty.ts

23 September 2026

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