JavaScript URL.canParse: проверить URL без исключения

Категория: JavaScript · Язык: JavaScript · Обновлено:

URL.canParse() проверяет, можно ли разобрать строку как URL, и возвращает boolean. В отличие от new URL(), он не выбрасывает исключение на некорректном значении. Это удобно для валидации пользовательского ввода и проверки ссылок перед обработкой.

Проверить абсолютный и относительный URL

JavaScript
console.log(URL.canParse("https://example.com/path")); // true
console.log(URL.canParse("/path", "https://example.com")); // true
console.log(URL.canParse("not a url"));                // false
console.log(URL.canParse("mailto:user@example.com"));  // true

Второй аргумент задаёт базу для относительных ссылок. Без базы /path не является абсолютным URL и вернёт false. Схемы вроде mailto: и javascript: синтаксически валидны, поэтому canParse не гарантирует безопасность — проверяйте допустимые схемы отдельно.

Разобрать URL после проверки

JavaScript
const value = "https://example.com/path?x=1";

if (URL.canParse(value)) {
    const url = new URL(value);
    console.log(url.host);   // example.com
    console.log(url.searchParams.get("x")); // 1
}

После canParse можно безопасно вызвать new URL без try/catch. Для относительных ссылок передайте ту же базу в оба вызова. URL.parse() (более новый метод) сразу возвращает объект или null, но его поддержка уже, чем у canParse.

canParse не делает запрос и не проверяет существование домена, доступность или сертификат. Для SSRF-защиты недостаточно синтаксической проверки: ограничьте схемы, хосты и порты, запретите private IP и проверяйте редиректы на сервере.

Метод поддерживается в Chrome 120+, Firefox 112+, Safari 17+ и Node.js 18.17+. В старых окружениях используйте try { new URL(value); return true } catch { return false }. Не передавайте в URL огромные строки без ограничения длины.

Документация: URL.canParse, URL.