前端處理用戶生成內容 (UGC) 時,必須淨化 HTML 防禦 XSS。單純正則不足,現代方案採用 DOMParser 白名單或成熟函式庫 DOMPurify。
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;
}
// 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 模式
});
jsdom:const createDOMPurify = require('dompurify'); const { JSDOM } = require('jsdom'); const window = new JSDOM('').window; const DOMPurify = createDOMPurify(window);SAFE_FOR_JQUERY、SAFE_FOR_TEMPLATES 等預設配置。若不需保留任何富文本,直接用 textContent:
element.textContent = userInput; // 瀏覽器自動編碼,零 XSS 風險
sanitize-html:配置豐富、效能佳。DOMPurify (isomorphic):前後端共用邏輯。<script>, <iframe>, <object>, <embed>, <form>, <input>, <button> 等互動標籤。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 所有案例。
RETURN_DOM / RETURN_DOM_FRAGMENT 避免序列化開銷。選對工具、建立測試、持續更新函式庫,才能持續防禦演進的 XSS 攻擊。