萬盛學電腦網

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

20 行代碼實現 CSS 覆蓋率檢測:發現項目中沉睡的樣式

為什麼需要 CSS 覆蓋率分析?

專案迭代久了,CSS 檔案常殘留大量廢棄規則——舊功能下線、重構遺留、實驗性樣式等。這些「死碼」不僅增加載入體積,還干擾維護。瀏覽器原生 document.styleSheets API 讓我們能輕鬆掃描全站樣式應用情況。

核心原理:三步走策略

  1. 遍歷 document.styleSheets 獲取所有 CSS 規則
  2. 取出 selectorText 傳給 document.querySelectorAll()
  3. 統計匹配元素數量 .length,按覆蓋率排序

完整實現代碼

const usage = [];
const sheets = document.styleSheets;

for (let i = sheets.length - 1; i >= 0; i--) {
  const rules = sheets[i].cssRules || sheets[i].rules; // 兼容 IE
  for (let j = rules.length - 1; j >= 0; j--) {
    const selector = rules[j].selectorText;
    if (!selector) continue; // 跳過 @media 等非選擇器規則
    
    try {
      const count = document.querySelectorAll(selector).length;
      usage.push({ selector, count });
    } catch (e) {
      console.warn(`選擇器無效: ${selector}`, e);
    }
  }
}

usage.sort((a, b) => b.count - a.count); // 高覆蓋率優先

console.table(usage.map(u => ({
  選擇器: u.selector,
  匹配數: u.count,
  狀態: u.count ? '✅ 活躍' : '⚠️ 疑似無用'
})));

實戰截圖分析

CSS 覆蓋率統計總覽

零匹配選擇器列表

關鍵避坑指南

❌ 零匹配 ≠ 可刪除

以下場景會導致誤判:

  • 狀態類::hover、:focus、:active 需交互觸發
  • 動態類:JS 控制的 .show、.hidden、[data-state="loading"]
  • 響應式:@media 內規則在特定視口才生效
  • 異域 iframe:跨域樣式表無法讀取(同源策略限制)

🛡 現代替代方案

Chrome DevTools Coverage 面板(Cmd+Shift+P → "Show Coverage")提供:

  • 即時精確的字節級覆蓋率
  • 支援 CSS/JS 雙向分析
  • 可導出報告供 CI/CD 集成

進階擴展:構建自動化清理流程

// Puppeteer 自動化掃描全站
const puppeteer = require('puppeteer');

async function auditCSSCoverage(urls) {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.coverage.startCSSCoverage();
  
  for (const url of urls) {
    await page.goto(url, { waitUntil: 'networkidle2' });
    // 觸發互動狀態
    await page.hover('a, button, input');
    await page.click('[tabindex]');
  }
  
  const coverage = await page.coverage.stopCSSCoverage();
  await browser.close();
  return coverage; // 含每個檔案的使用率、未用字節範圍
}

總結

20 行原生 JS 即可構建基礎掃描器,適合快速排查;生產環境建議接入 Puppeteer + Coverage API 實現全自動化、全場景的 CSS 健康度監控。記住:工具只能發現疑點,人工驗證才能確認廢棄——保留那 1% 的「可能有用」總比誤刪 0.1% 的「關鍵樣式」安全。

copyright © 萬盛學電腦網 all rights reserved