萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

JavaScript 過濾 HTML 標籤實戰:DOMParser 白名單、DOMPurify 與安全檢查清單

JavaScript 過濾 HTML 標籤實戰指南

前端處理用戶生成內容 (UGC) 時,必須淨化 HTML 防禦 XSS。單純正則不足,現代方案採用 DOMParser 白名單或成熟函式庫 DOMPurify。

方案一:原生 DOMParser 白名單 (零依賴)

function sanitizeHTML(html, options = {}) {
  const {
    allowedTags = ['b', 'i', 'em', 'strong', 'a', 'p', 'br', 'ul', 'ol', 'li', 'span'],
    allowedAttrs = { a: ['href', 'title', 'target', 'rel'], span: ['class'] },
    allowedSchemes = ['http:', 'https:', 'mailto:', 'tel:'],
  } = options;

  const doc = new DOMParser().parseFromString(html, 'text/html');
  const walker = document.createTreeWalker(doc.body, NodeFilter.SHOW_ELEMENT);

  while (walker.nextNode()) {
    const el = walker.currentNode;
    const tag = el.tagName.toLowerCase();

    if (!allowedTags.includes(tag)) {
      el.replaceWith(...el.childNodes); // 移除標籤保留內容
      continue;
    }

    [...el.attributes].forEach(attr => {
      const name = attr.name.toLowerCase();
      const allowed = allowedAttrs[tag] || [];
      if (!allowed.includes(name)) {
        el.removeAttribute(name);
        return;
      }
      // URL scheme 驗證
      if (name === 'href' && allowedSchemes.length) {
        try {
          const url = new URL(attr.value, location.origin);
          if (!allowedSchemes.includes(url.protocol)) el.removeAttribute(name);
        } catch { el.removeAttribute(name); }
      }
      // target="_blank" 強制加安全 rel
      if (tag === 'a' && name === 'target' && attr.value === '_blank') {
        el.setAttribute('rel', 'noopener noreferrer');
      }
    });
  }
  return doc.body.innerHTML;
}

方案二:DOMPurify (推薦生產環境)

// npm install dompurify
import DOMPurify from 'dompurify';

const clean = DOMPurify.sanitize(dirty, {
  ALLOWED_TAGS: ['b', 'i', 'em', 'strong', 'a', 'p', 'br', 'ul', 'ol', 'li'],
  ALLOWED_ATTR: ['href', 'title', 'target', 'rel', 'class'],
  ADD_ATTR: ['target'], // 允許 target 但會自動加 noopener
  FORBID_TAGS: ['script', 'style', 'iframe', 'object', 'embed', 'form', 'input'],
  FORBID_ATTR: ['on*', 'style', 'onclick'],
  USE_PROFILES: { html: true }, // HTML 模式
});
  • 支援 Node.js (isomorphic) 需搭配 jsdom:const createDOMPurify = require('dompurify'); const { JSDOM } = require('jsdom'); const window = new JSDOM('').window; const DOMPurify = createDOMPurify(window);
  • 內建處理編碼繞過、SVG/MathML、CSS expression、mutation XSS 等數百種攻擊向量。
  • 效能優化:支援 SAFE_FOR_JQUERY、SAFE_FOR_TEMPLATES 等預設配置。

方案三:純文字顯示 (最安全、最簡單)

若不需保留任何富文本,直接用 textContent:

element.textContent = userInput; // 瀏覽器自動編碼,零 XSS 風險

Node.js 後端同步淨化

  • sanitize-html:配置豐富、效能佳。
  • DOMPurify (isomorphic):前後端共用邏輯。

XSS 安全檢查清單 (OWASP Cheat Sheet 精簡版)

  1. 移除 <script>, <iframe>, <object>, <embed>, <form>, <input>, <button> 等互動標籤。
  2. 2. 移除所有 on* 事件屬性、style (CSS expression)、href/src 的 javascript:, data:, vbscript: 協定。 3. 處理編碼繞過:雙重編碼、Unicode 正規化、字元實體混淆。 4. SVG/MathML 命名空間攻擊向量。 5. Mutation XSS (mXSS):瀏覽器解析重組導致安全標籤變危險 (如 <noscript><p title="</noscript><img src=x onerror=alert(1)>">)。 6. 單元測試覆蓋 OWASP XSS Filter Evasion Cheat Sheet 所有案例。

效能優化

  • 大量內容用 Web Worker 離主執行緒。
  • 快取淨化結果 (Key: hash(原始 HTML + 配置版本))。
  • DOMPurify RETURN_DOM / RETURN_DOM_FRAGMENT 避免序列化開銷。

選對工具、建立測試、持續更新函式庫,才能持續防禦演進的 XSS 攻擊。

copyright © 萬盛學電腦網 all rights reserved