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() 說明

參考資料:

WHATWG URL Standard:URL.parse

MDN:URL.parse()

MDN:URL.canParse()

JavaScript URL.parse() 怎麼用?以 null 處理無效網址
https://laplusda.com/posts/javascript-url-parse-invalid-input/
作者
Zero
發佈於
2026-11-19
許可協議
CC BY-NC-SA 4.0