# @aegisjsproject/trusted-types 中文文档

规范地址：https://npmcn.com/package/%40aegisjsproject/trusted-types/

版本：1\.1\.0
npm 元数据更新时间：2026-06-14T16:16:03.206Z
中文译文更新时间：2026-11-06T22:42:51.433Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aegisjsproject/trusted-types
原文对照：https://npmcn.com/package/%40aegisjsproject/trusted-types/?lang=original
项目主页：https://github.com/AegisJSProject/trusted-types#readme
源码仓库：https://github.com/AegisJSProject/trusted-types

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：65.9 kB，13 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：0 个
- 首次发布：2024-04-02T00:51:40.448Z
- 最新版本发布：2026-06-14T16:16:02.869Z
- 近 30 天下载量：2224（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 1 个）

## 中文简介

信任类型 API 的多填充

## 安装

```sh
npm install @aegisjsproject/trusted-types
```

也可以使用：`pnpm add @aegisjsproject/trusted-types`、`yarn add @aegisjsproject/trusted-types`、`bun add @aegisjsproject/trusted-types`

## README

# @aegisjsproject/受托类型

用于 [信任类型 API](https://developer.mozilla.org/en-US/docs/Web/API/Trusted_Types_API)

[![CodeQL](https://github.com/AegisJSProject/trusted-types/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/AegisJSProject/trusted-types/actions/workflows/codeql-analysis.yml) ![Node CI](https://github.com/AegisJSProject/trusted-types/workflows/Node%20CI/badge.svg) ![Lint Code Base](https://github.com/AegisJSProject/trusted-types/workflows/Lint%20Code%20Base/badge.svg)

[![GitHub license](https://img.shields.io/github/license/AegisJSProject/trusted-types.svg)](https://github.com/AegisJSProject/trusted-types/blob/master/LICENSE) [![GitHub last commit](https://img.shields.io/github/last-commit/AegisJSProject/trusted-types.svg)](https://github.com/AegisJSProject/trusted-types/commits/master) [![GitHub release](https://img.shields.io/github/release/AegisJSProject/trusted-types?logo=github)](https://github.com/AegisJSProject/trusted-types/releases) [![GitHub Sponsors](https://img.shields.io/github/sponsors/shgysk8zer0?logo=github)](https://github.com/sponsors/shgysk8zer0)

[![npm](https://img.shields.io/npm/v/@aegisjsproject/trusted-types)](https://www.npmjs.com/package/@aegisjsproject/trusted-types) ![node-current](https://img.shields.io/node/v/@aegisjsproject/trusted-types) ![npm bundle size gzipped](https://img.shields.io/bundlephobia/minzip/@aegisjsproject/trusted-types) [![npm](https://img.shields.io/npm/dw/@aegisjsproject/trusted-types?logo=npm)](https://www.npmjs.com/package/@aegisjsproject/trusted-types)

[![GitHub followers](https://img.shields.io/github/followers/AegisJSProject.svg?style=social)](https://github.com/AegisJSProoject) ![GitHub forks](https://img.shields.io/github/forks/AegisJSProject/trusted-types.svg?style=social) ![GitHub stars](https://img.shields.io/github/stars/AegisJSProject/trusted-types.svg?style=social) [![Twitter Follow](https://img.shields.io/twitter/follow/shgysk8zer0.svg?style=social)](https://twitter.com/shgysk8zer0)

[![Donate using Liberapay](https://img.shields.io/liberapay/receives/shgysk8zer0.svg?logo=liberapay)](https://liberapay.com/shgysk8zer0/donate "Donate using Liberapay")

* * *

-   [行为守则](https://npmcn.com/package/%40aegisjsproject/trusted-types/.github/CODE_OF_CONDUCT.md)
-   [捐款](https://npmcn.com/package/%40aegisjsproject/trusted-types/.github/CONTRIBUTING.md)
-   [安全政策](https://npmcn.com/package/%40aegisjsproject/trusted-types/.github/SECURITY.md)

## [概念和使用](https://developer.mozilla.org/en-US/docs/Web/API/Trusted_Types_API#concepts_and_usage)

用户控制数据时会发生客户端或基于DOM的XSS攻击 (例如输入窗体字段)达到可以执行的函数 数据。 这些功能被称为注入汇. 基于 DOM 的 XSS 攻击发生 当用户能够写入任意 JavaScript 代码并用一个执行时 这些职能.

信任类型 API 锁定有风险的注入汇, 需要您处理 将数据传递给其中之一。 如果您使用字符串, 那么 浏览器将丢出 TypeError 并阻止该函数的使用.

信任类型同时工作 [内容-安全政策](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP) 与 [`trusted-types`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/trusted-types) 财务报告和审定财务报表 [`require-trusted-types-for`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/require-trusted-types-for) 指令。 。 .

### [注射信条](https://developer.mozilla.org/en-US/docs/Web/API/Trusted_Types_API#injection_sinks)

Trusted Types API 锁定可充当 DOM 的向量的注入汇 。 预算外 攻击。 注入槽是任何只应该取名的 Web API 函数 与可信、验证或消毒输入。 注入汇的例子包括:

-   在文档中插入 HTML 的函数, 如 Element. innerHTML, Element.outerHTML, 或者 Document.write .
-   函数创建新的同源文档, 并使用调用器控制的标记, 如 DOMParser. parseFromString .
-   执行Global Objects/eval等代码的函数.
-   用于 Element 属性的设置器,用于接受代码的 URL 来加载或执行 .

信任类型会迫使您在将数据传递给任何 注入槽而不是使用字符串。 这可确保数据可信.

> \[大 由于文档不能直接访问 HTTP 信头, 此多填充需要 无论是 `<meta http-equiv="Content-Security-Policy">` 或一个 `data-trusted-policies` 要设置的属性 `<html>`。 。 。 .

信任类型 API 给网页开发者一个锁定不安全部分的方法 用于防止客户端跨站点脚本(XSS)攻击的 DOM API.

## 包含脚本/模块

-   **`trusted-types`**: 填充 `globalThis.trustedTypes` 对象
-   **`harden`**: 覆盖“ 注入槽” 属性设置器( L)
-   **`bundle`**: 加载多填充和有条件的"硬"s

## 常见问题

### @aegisjsproject/trusted-types 是什么？

信任类型 API 的多填充

### 如何安装 @aegisjsproject/trusted-types？

在项目目录运行 npm install @aegisjsproject/trusted-types，或使用 pnpm add / yarn add / bun add。

### @aegisjsproject/trusted-types 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/aegisjsproject\_\_trusted-types 是否存在。

### @aegisjsproject/trusted-types 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @aegisjsproject/trusted-types 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @aegisjsproject/trusted-types 可以商用吗？

@aegisjsproject/trusted-types 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @aegisjsproject/trusted-types 的下载量有多少？

根据 npm 官方下载统计，@aegisjsproject/trusted-types 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,224 次，日均约 74 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aegisjsproject/trusted-types 还在维护吗？

最新版本 1\.1\.0 发布于 2026/06/15（4 个月前）；至今共发布 4 个版本，其中过去 12 个月发布了 1 个；首次发布于 2024/04/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。