所有屬性均可透過 window.location、document.location 或直接 location 存取。
| 屬性 | 範例輸出 | 說明 |
|---|---|---|
href | https://example.com:8080/path/page.html?query=1#hash | 完整 URL (可讀寫,寫入會導航) |
protocol | https: | 協定方案 (含冒號) |
host | example.com:8080 | 主機名 + 埠口 (若為預設埠則省略) |
hostname | example.com | 主機名 (不含埠口) |
port | 8080 | 埠口號 (空字串表示預設埠) |
pathname | /path/page.html | 路徑 (以 / 開頭) |
search | ?query=1 | 查詢字串 (含 ?) |
hash | #hash | 錨點 (含 #) |
origin | https://example.com:8080 | 只讀:protocol + host (ES2015+) |
// 以下皆指向同一 Location 物件
window.location === document.location; // true
window.location === location; // true
self.location === location; // true (非跨域 iframe)
top.location === location; // true (非巢狀 iframe)
// 完整 URL 等價寫法
document.URL; // 唯讀,同 location.href
document.location.href; // 同 location.href
self.location.href; // 同 location.href
top.location.href; // 最上層視窗 URL (跨域時受限)
function parseQueryString(search = location.search) {
const params = new URLSearchParams(search);
const obj = {};
for (const [k, v] of params) {
if (obj[k] === undefined) obj[k] = v;
else if (Array.isArray(obj[k])) obj[k].push(v);
else obj[k] = [obj[k], v];
}
return obj;
}
// 用法
const q = parseQueryString(); // { query: "1", arr: ["a","b"] }
function buildUrl(base, params) {
const url = new URL(base);
Object.entries(params).forEach(([k, v]) => {
if (Array.isArray(v)) v.forEach(val => url.searchParams.append(k, val));
else url.searchParams.set(k, v);
});
return url.toString();
}
buildUrl("/api/users", { page: 2, tags: ["js", "css"], sort: "desc" });
// "/api/users?page=2&tags=js&tags=css&sort=desc"
const cleanPath = location.origin + location.pathname;
// "https://example.com/path/page.html"
const isSecure = location.protocol === "https:"; // 或 location.isSecureContext (需安全上下文)
在 DevTools Console 直接輸入:
// 列出所有屬性
console.table(Object.getOwnPropertyDescriptors(location));
// 監聽 URL 變化 (SPA 路由)
window.addEventListener("popstate", () => console.log("URL changed:", location.href));
// 或針對 hash 變化
window.addEventListener("hashchange", () => console.log("Hash:", location.hash));
iframe.contentWindow.location。location.href (會拋出 SecurityError);但可**寫入** iframe.contentWindow.location = "new-url" 導航 iframe。postMessage。location.href、location.pathname、location.search、location.hash 最常用。URLSearchParams (現代標準),勿手寫 split 正則。URL 建構子,自動處理編碼與特殊字元。document.URL 唯讀,location.href 可寫入導航,語意上區分「讀取」與「跳轉」。