501 字
3 分鐘
JavaScript URL.parse() 怎麼用?以 null 處理無效網址
驗證於
使用者貼錯網址時,JavaScript 的 URL.parse() 會在解析失敗時回傳 null,成功時則給你可讀取 protocol、hostname 等屬性的 URL 物件。表單只需知道格式能否解析時,可以用 URL.canParse()。後面還要用網址物件時,直接呼叫 URL.parse() 即可。WHATWG URL Standard
四種資料放進同一個連結欄位
假設個人資料表單接受可留空、以 HTTP 或 HTTPS 解析的絕對網址。先把空白判成未填,再解析。解析成功後仍要比對欄位接受的通訊協定,例如 mailto 格式可以解析,卻不適合這個欄位。
下面程式可存成 .mjs 以 Node.js 執行,並同時測試使用 URL.parse() 和解析失敗時捕捉 TypeError 的回退路徑。
import assert from 'node:assert/strict';
function parseWithConstructor(text) { try { return new URL(text); } catch (error) { if (error instanceof TypeError) return null; throw error; }}
function readWebsite(input, parse) { const text = input.trim(); if (text === '') return { kind: 'empty' };
const url = parse(text); if (!url) return { kind: 'invalid' }; if (!['http:', 'https:'].includes(url.protocol)) { return { kind: 'unsupported' }; } return { kind: 'valid', href: url.href };}
const parsers = [parseWithConstructor];if (typeof URL.parse === 'function') { parsers.push((text) => URL.parse(text));}
for (const parse of parsers) { assert.deepEqual(readWebsite(' ', parse), { kind: 'empty' }); assert.deepEqual(readWebsite('https://[', parse), { kind: 'invalid' }); assert.deepEqual(readWebsite('mailto:hi@example.com', parse), { kind: 'unsupported' }); assert.deepEqual(readWebsite('example.com', parse), { kind: 'invalid' }); assert.deepEqual(readWebsite(' HTTPS://Example.com ', parse), { kind: 'valid', href: 'https://example.com/', });}
if (typeof URL.canParse === 'function') { assert.equal(URL.canParse('https://['), false); assert.equal(URL.canParse('mailto:hi@example.com'), true);}console.log('通過的解析路徑數', parsers.length);範例刻意省略 base,讓缺少通訊協定的 example.com 被判為格式錯誤。若欄位明確接受站內相對路徑,再傳入 base 並驗實際結果。遇到 v1 被吃掉或路徑跑到網站根目錄時,可用 new URL() 的尾斜線與相對網址對照找出原因。
URL.parse() 的 null 表示字串未能解析。若資料來自 API,可能收到非字串,應在呼叫欄位檢查前先驗型別。這一組驗收只處理表單內容,沒有發出 HTTP 請求,也不判定網址能否連線。MDN 的 URL.parse() 說明
參考資料:
JavaScript URL.parse() 怎麼用?以 null 處理無效網址
https://laplusda.com/posts/javascript-url-parse-invalid-input/