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) на основе исходного кода библиотеки.