requireValidDomain

function requireValidDomain(
  domain: unknown,
  message: string = "Expected a valid domain name."
): string;

Метки, разделённые одиночными точками, без точки или дефиса в начале и в конце и без пустых меток. Это проверка синтаксиса: резолвится ли домен — отдельный вопрос.

isX и nonX отвечают на вопрос и никогда не прерывают выполнение; requireX и requireNonX возвращают значение или выбрасывают исключение. Схема разобрана в Соглашения о проверках.

Параметры

Параметр	Тип	Описание
`domain`	`unknown`	The value to validate as a domain name.
`message` (необязательный) `= "Expected a valid domain name."`	`string`	Сообщение исключения. Если не задано, используется сообщение по умолчанию.

Возвращает

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

Исключения

Исключение	Условие
`IllegalArgumentException`	значение не является доменным именем.

Примеры

Что проходит, а что нет

requireValidDomain("example.com"); // => "example.com"
requireValidDomain("sub.example.co.uk"); // => "sub.example.co.uk"
requireValidDomain("-example.com"); // throws IllegalArgumentException
requireValidDomain("example..com"); // throws IllegalArgumentException

Смотрите также

Исходный код

src/net/path/requireValidDomain.ts

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.