requireValidEmail

function requireValidEmail(email: string | null | undefined, message?: string): string;

L'adresse est coupée sur un unique @: le domaine est vérifié comme le fait isValidDomain, et la partie locale doit être non vide et sans espaces. C'est un contrôle de format, pas la preuve que la boîte existe.

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
`email`	`string \\| null \\| undefined`	The string value representing an email to validate. Can be `null` or `undefined`.
`message` (facultatif)	`string`	Le message de l'exception. À défaut, un message par défaut est utilisé.

Valeur de retour

string — la même valeur, typée comme une adresse e-mail.

Exceptions

Exception	Condition
`InvalidEmailFormatException`	la valeur n'est pas une adresse e-mail.

Exemples

Ce qui passe et ce qui ne passe pas

requireValidEmail("user@example.com"); // => "user@example.com"
requireValidEmail("first.last@sub.example.co.uk"); // => "first.last@sub.example.co.uk"
requireValidEmail("user@@example.com"); // throws InvalidEmailFormatException
requireValidEmail("user@"); // throws InvalidEmailFormatException

Voir aussi

Code source

src/lang/string/requireValidEmail.ts

23 September 2026

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