requireValidEmail

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

Die Adresse wird an genau einem @ geteilt: die Domain wird geprüft wie von isValidDomain, der lokale Teil muss nicht leer und frei von Leerzeichen sein. Eine Formatprüfung, kein Beleg dafür, dass das Postfach existiert.

isX und nonX beantworten eine Frage und unterbrechen den Ablauf nie; requireX und requireNonX geben den Wert zurück oder werfen. Das Schema erklärt Konventionen der Prüfungen.

Parameter

Parameter	Typ	Beschreibung
`email`	`string \\| null \\| undefined`	The string value representing an email to validate. Can be `null` or `undefined`.
`message` (optional)	`string`	Die Meldung der Ausnahme. Ohne Angabe wird eine Standardmeldung verwendet.

Rückgabewert

string — denselben Wert, typisiert als eine E-Mail-Adresse.

Ausnahmen

Ausnahme	Bedingung
`InvalidEmailFormatException`	der Wert ist nicht eine E-Mail-Adresse.

Beispiele

Was besteht und was nicht

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

Siehe auch

Quellcode

src/lang/string/requireValidEmail.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.