requireNonSymbol

function requireNonSymbol<T>(
  value: T | symbol,
  message: string = "Expected a non-symbol value."
): T;

Les symboles enregistrés par Symbol.for et les symboles bien connus passent tous deux ; rien d'autre.

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 \\| symbol`	La valeur à valider.
`message` (facultatif) `= "Expected a non-symbol 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 symbole.

Exceptions

Exception	Condition
`IllegalArgumentException`	la valeur est un symbole.

Exemples

Ce qui passe et ce qui ne passe pas

requireNonSymbol("id"); // => "id"
requireNonSymbol(null); // => null
requireNonSymbol(Symbol("id")); // throws IllegalArgumentException
requireNonSymbol(Symbol.iterator); // throws IllegalArgumentException

Voir aussi

Code source

src/lang/base/requireNonSymbol.ts

23 September 2026

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