JavaScript URL.canParse: проверить URL без исключения
URL.canParse() проверяет, можно ли разобрать строку как URL, и возвращает boolean. В отличие от new URL(), он не выбрасывает исключение на некорректном значении. Это удобно для валидации пользовательского ввода и проверки ссылок перед обработкой.
Проверить абсолютный и относительный URL
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 после проверки
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.