@element-hq/element-web-shared-utils (中文(简体) )
独立,由元素项目共享的公用事业.
该软件包提供基于字符串的 HTML 消毒和 URL 验证
无法信任的矩阵兼容格式化内容 。 它的目的是在
元素Web以及外部的JavaScript和TypeScript包.
使用量
import { isUrlPermitted, sanitizeHtml } from "@element-hq/element-web-shared-utils";
const safeHtml = sanitizeHtml(untrustedHtml);
const canOpen = isUrlPermitted(untrustedUrl);
软件包不导入 React, 访问浏览器全局, 也不依赖于
元素Web应用程序代码.
默认消毒器应用共享元素 Web 渲染和安全性
政策,包括安全链接处理、只使用 MXC 图像以及删除内线
样式。 这个 transformTags 选项是信任的应用程序扩展点 :
为标签提供变换,以取代标签的共享渲染变换.
应用程序应只用于故意缩小范围或明确
信任的渲染语境 。 Anchor URL 验证和消毒器属性
和 URL 检查活动 .
版权许可( L)
版权 (c)2026元素创造有限公司.
该软件根据存储许可证所述条款获得许可
文档.
发布新版本
为了执行释放,见文件: ../RELEASING.md。 。 。 .
关于 @element-hq/element-web-shared-utils 的常见问题
@element-hq/element-web-shared-utils 是什么？
元素网络共享公用事业
如何安装 @element-hq/element-web-shared-utils？
在项目目录运行 npm install @element-hq/element-web-shared-utils，或使用 pnpm add / yarn add / bun add。
@element-hq/element-web-shared-utils 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
@element-hq/element-web-shared-utils 支持 ESM 还是 CommonJS？
同时提供 ES Module 与 CommonJS 入口，import 和 require() 都可以使用，打包工具会自动选择合适的版本。
@element-hq/element-web-shared-utils 需要什么版本的 Node.js？
package.json 的 engines 字段要求 Node.js >=20.0.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
@element-hq/element-web-shared-utils 可以商用吗？
@element-hq/element-web-shared-utils 使用 SEE LICENSE IN README.md 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。
@element-hq/element-web-shared-utils 的下载量有多少？
根据 npm 官方下载统计，@element-hq/element-web-shared-utils 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,247 次，日均约 75 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@element-hq/element-web-shared-utils 还在维护吗？
最新版本 0.1.0 发布于 2026/09/09（2 个月前）；至今共发布 2 个版本，其中过去 12 个月发布了 2 个；首次发布于 2026/09/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。