requireUrl

function requireUrl(value: unknown, message: string = "Expected a valid URL."): string;

Адреса за схемою http, https або ftp, у якої після схеми щось є і ніде немає пробілів. Голий хост на кшталт "example.com" нею не є.

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

Параметри

Параметр	Тип	Опис
`value`	`unknown`	Значення, яке потрібно перевірити.
`message` (необов'язковий) `= "Expected a valid URL."`	`string`	Повідомлення винятку. Якщо не задано, використовується типове повідомлення.

Повертає

string — те саме значення, вже перевірене як URL-адресу.

Винятки

Виняток	Умова
`IllegalArgumentException`	значення не є URL-адресою.

Приклади

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

requireUrl("https://example.com"); // => "https://example.com"
requireUrl("http://example.com/a?b=1"); // => "http://example.com/a?b=1"
requireUrl("example.com"); // throws IllegalArgumentException
requireUrl("https://"); // throws IllegalArgumentException

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

Вихідний код

src/net/url/requireUrl.ts

23 September 2026

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