document.getElementById() 只回傳第一個元素,重複 ID 導致選取錯誤label for="id" 關聯失效#id 樣式套用到多個元素// 在 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>
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 單元測試
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-eslint | extends: ['plugin:html/recommended'],規則 html/require-id-uniqueness |
| Vue CLI / Vite | vue/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 雜湊表,並加入視覺標記輔助定位。