萬盛學電腦網

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

JavaScript 檢測頁面重複 ID 完整方案:開發除錯與自動化測試

為何需要檢測重複 ID

  • document.getElementById() 只回傳第一個元素,重複 ID 導致選取錯誤
  • label for="id" 關聯失效
  • CSS #id 樣式套用到多個元素
  • 自動化測試選取器不穩定
  • 無障礙工具報錯

方案一:開發工具 Console 單次檢測 (最簡單)

// 在 DevTools Console 直接執行
(function() {
    const ids = [];
    const duplicates = [];
    document.querySelectorAll('[id]').forEach(el => {
        if (ids.includes(el.id)) duplicates.push(el.id);
        else ids.push(el.id);
    });
    console.table(duplicates.length ? duplicates : ['無重複 ID']);
})();

方案二:頁面載入自動檢測並報警 (原文方法一重構)

<script>
window.addEventListener('load', function() {
    const seen = new Set();
    const dupes = [];
    document.querySelectorAll('[id]').forEach(el => {
        if (seen.has(el.id)) dupes.push(el.id);
        else seen.add(el.id);
    });
    if (dupes.length) {
        console.error('發現重複 ID:', dupes);
        // 可選:視覺標記
        dupes.forEach(id => {
            document.querySelectorAll('#' + CSS.escape(id)).forEach((el, i) => {
                el.style.outline = `3px solid ${i === 0 ? 'blue' : 'red'}`;
                el.title = `重複 ID: ${id} (第 ${i+1} 個)`;
            });
        });
    } else {
        console.log('✅ 頁面無重複 ID');
    }
});
</script>

方案三:統計各 ID 出現次數 (原文方法二重構)

function auditDuplicateIds() {
    const counts = {};
    document.querySelectorAll('[id]').forEach(el => {
        counts[el.id] = (counts[el.id] || 0) + 1;
    });
    const result = Object.entries(counts)
        .filter(([_, count]) => count > 1)
        .map(([id, count]) => `${id} (×${count})`);
    
    if (result.length) {
        console.warn('重複 ID 統計:', result.join(', '));
        return result;
    }
    console.log('無重複 ID');
    return [];
}

方案四:自動化測試整合 (Jest + JSDOM / Cypress)

// Jest + JSDOM 單元測試
test('頁面不應有重複 ID', () => {
    document.body.innerHTML = `
        <div id="a"></div>
        <span id="a"></span>
        <input id="b">
    `;
    const dupes = auditDuplicateIds();
    expect(dupes).toHaveLength(0); // 失敗,會顯示 "a (×2)"
});

// Cypress E2E 測試
it('生產環境頁面無重複 ID', () => {
    cy.visit('/dashboard');
    cy.window().then(win => {
        const dupes = win.auditDuplicateIds();
        expect(dupes).to.have.length(0);
    });
});

方案五:建置時期靜態檢查 (最推薦,左移品質)

工具配置方式
HTMLHint.htmlhintrc: { "id-class-value": "dash", "id-unique": true }
ESLint + html-eslintextends: ['plugin:html/recommended'],規則 html/require-id-uniqueness
Vue CLI / Vitevue/compiler-sfc 編譯時自動檢測 template 重複 ID
React (JSX)ESLint jsx-a11y/no-noninteractive-element-interactions 相關規則

進階:動態新增元素的持續監控

// MutationObserver 監控 DOM 變動
const observer = new MutationObserver(mutations => {
    let hasNewId = false;
    mutations.forEach(m => {
        m.addedNodes.forEach(node => {
            if (node.nodeType === 1) { // Element
                if (node.id) checkSingleId(node.id);
                node.querySelectorAll('[id]').forEach(el => checkSingleId(el.id));
            }
        });
    });
});

const seenIds = new Set();
function checkSingleId(id) {
    if (seenIds.has(id)) {
        console.error('動態新增重複 ID:', id);
    } else {
        seenIds.add(id);
    }
}

observer.observe(document.body, { childList: true, subtree: true });

總結

檢測重複 ID 分層策略:建置期靜態分析 (首選) → 開發期 Console 自檢 → 測試期自動化斷言 → 運行期 MutationObserver 監控。原文兩種迴圈檢測邏輯正確但可簡化為 Set/Object 雜湊表,並加入視覺標記輔助定位。

copyright © 萬盛學電腦網 all rights reserved