萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 獲取當前頁面 URL 與位置資訊完整速查表

Location 物件屬性速查

所有屬性均可透過 window.location、document.location 或直接 location 存取。

屬性範例輸出說明
hrefhttps://example.com:8080/path/page.html?query=1#hash完整 URL (可讀寫,寫入會導航)
protocolhttps:協定方案 (含冒號)
hostexample.com:8080主機名 + 埠口 (若為預設埠則省略)
hostnameexample.com主機名 (不含埠口)
port8080埠口號 (空字串表示預設埠)
pathname/path/page.html路徑 (以 / 開頭)
search?query=1查詢字串 (含 ?)
hash#hash錨點 (含 #)
originhttps://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 (跨域時受限)

實用工具函式

1. 解析查詢字串為物件

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"] }

2. 組合新 URL (安全編碼)

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"

3. 取得當前頁面不含查詢與錨點的純路徑

const cleanPath = location.origin + location.pathname;
// "https://example.com/path/page.html"

4. 判斷是否為安全連線 (HTTPS)

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 限制

  • 同源:可自由存取 iframe.contentWindow.location。
  • 跨域:無法讀取 iframe 內部 location.href (會拋出 SecurityError);但可**寫入** iframe.contentWindow.location = "new-url" 導航 iframe。
  • 需跨域通訊請使用 postMessage。

總結

  • 日常開發以 location.href、location.pathname、location.search、location.hash 最常用。
  • 解析 Query String 請用 URLSearchParams (現代標準),勿手寫 split 正則。
  • 組合 URL 請用 URL 建構子,自動處理編碼與特殊字元。
  • document.URL 唯讀,location.href 可寫入導航,語意上區分「讀取」與「跳轉」。
copyright © 萬盛學電腦網 all rights reserved