萬盛學電腦網

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

JavaScript 取得當前頁面名稱:三種方法完整比較與最佳實務

取得當前頁面檔案名稱是常見需求 (麵包屑、分析追蹤、條件渲染)。本文比較三種方法:location.href 字串處理、URL API、document.location 屬性,並處理查詢字串、雜湊、邊界情況。

方法一:字串分割 (傳統相容)

// 不帶副檔名
function getPageNameNoExt() {
    var href = location.href;
    var filename = href.substring(href.lastIndexOf('/') + 1); // 取最後一段
    return filename.split('.')[0] || 'index'; // 移除副檔名,預設 index
}

// 帶副檔名
function getPageNameWithExt() {
    var href = location.href;
    return href.substring(href.lastIndexOf('/') + 1) || 'index.html';
}

方法二:URL API (現代標準、推薦)

function getPageNameModern() {
    try {
        var url = new URL(location.href);
        var pathname = url.pathname; // 如 /path/to/page.html
        var filename = pathname.split('/').pop() || 'index';
        
        // 移除副檔名
        var nameOnly = filename.replace(/\.[^/.]+$/, '');
        return nameOnly;
    } catch (e) {
        // URL 建構失敗 fallback
        return getPageNameNoExt();
    }
}

// 進階:取得完整路徑資訊
function getPageInfo() {
    var url = new URL(location.href);
    return {
        href: url.href,
        origin: url.origin,           // https://example.com
        pathname: url.pathname,       // /path/page.html
        filename: url.pathname.split('/').pop() || 'index',
        nameOnly: url.pathname.split('/').pop()?.replace(/\.[^/.]+$/, '') || 'index',
        search: url.search,           // ?id=123&tab=detail
        hash: url.hash,               // #section-1
        searchParams: Object.fromEntries(url.searchParams) // {id: '123', tab: 'detail'}
    };
}

方法三:document.location 屬性存取

// 僅檔名 (含副檔名)
var filename = document.location.pathname.split('/').pop();

// 無副檔名
var nameOnly = filename.replace(/\.[^/.]+$/, '');

三種方法比較表

特性字串分割URL APIdocument.location
瀏覽器支援IE6+IE10+ (需 Polyfill)全支援
處理查詢字串手動處理內建 searchParams手動處理
處理雜湊手動處理內建 hash手動處理
編碼處理手動 decodeURIComponent自動解碼自動解碼
效能極快稍慢 (建構物件)極快
可讀性/維護性低高中

邊界情況處理

function robustGetPageName() {
    var url = new URL(location.href);
    var pathname = url.pathname;
    
    // 1. 根路徑 "/"
    if (pathname === '/' || pathname === '') return 'index';
    
    // 2. 目錄結尾 "/blog/" → 視為 index
    if (pathname.endsWith('/')) {
        return 'index'; // 或取得目錄名
    }
    
    // 3. 正常檔案
    var filename = pathname.split('/').pop();
    
    // 4. 多重副檔名 .min.js、.tar.gz → 只移除最後一段
    return filename.replace(/\.[^/.]+$/, '');
}

實務應用範例

1. 動態載入對應 CSS/JS

var pageName = getPageNameModern();
// 載入頁面專用樣式
var link = document.createElement('link');
link.rel = 'stylesheet';
link.href = '/css/pages/' + pageName + '.css';
document.head.appendChild(link);

2. Google Analytics 頁面追蹤

gtag('config', 'GA_MEASUREMENT_ID', {
    page_title: document.title,
    page_path: location.pathname,
    page_location: location.href
});

3. 條件式導航高亮

var currentPage = getPageNameModern();
document.querySelectorAll('.nav a').forEach(link => {
    var href = new URL(link.href, location.origin);
    if (href.pathname.split('/').pop().replace(/\.[^/.]+$/, '') === currentPage) {
        link.classList.add('active');
        link.setAttribute('aria-current', 'page');
    }
});

TypeScript 類型安全版本

interface PageInfo {
    filename: string;
    nameOnly: string;
    pathname: string;
    searchParams: Record;
    hash: string;
}

function getPageInfo(): PageInfo {
    const url = new URL(window.location.href);
    const filename = url.pathname.split('/').pop() || 'index';
    return {
        filename,
        nameOnly: filename.replace(/\.[^/.]+$/, ''),
        pathname: url.pathname,
        searchParams: Object.fromEntries(url.searchParams),
        hash: url.hash
    };
}

總結建議

  1. 現代專案:直接使用 URL API,語意清晰、自動處理編碼、支援查詢參數解析
  2. 需支援 IE10-:引入 url-polyfill 或使用字串分割 fallback
  3. 效能極度敏感:location.pathname.split('/').pop() 最輕量
  4. 統一封裝:專案建立 utils/page.js 統一匯出,避免分散複製貼上

善用 URL API 不只取得檔名,更能輕鬆處理查詢參數、雜湊、來源比對等複雜需求。

copyright © 萬盛學電腦網 all rights reserved