requireValidEmail

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

Адреса розбивається за єдиним @: домен перевіряється так само, як у isValidDomain, а локальна частина має бути непорожньою і без пробілів. Це перевірка формату, а не доказ того, що скринька існує.

isX та nonX відповідають на питання й ніколи не переривають виконання; requireX і requireNonX повертають значення або викидають виняток. Схему розібрано в Домовленості про перевірки.

Параметри

Параметр	Тип	Опис
`email`	`string \\| null \\| undefined`	The string value representing an email to validate. Can be `null` or `undefined`.
`message` (необов'язковий)	`string`	Повідомлення винятку. Якщо не задано, використовується типове повідомлення.

Повертає

string — те саме значення, вже перевірене як адресу електронної пошти.

Винятки

Виняток	Умова
`InvalidEmailFormatException`	значення не є адресою електронної пошти.

Приклади

Що проходить, а що ні

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

Дивіться також

Вихідний код

src/lang/string/requireValidEmail.ts

23 September 2026

Цю документацію згенеровано нейромережею (Claude) на основі вихідного коду бібліотеки.