solely 0.1.7 → 0.1.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +44 -1
- package/dist/index.js +332 -269
- package/dist/index.umd.cjs +11 -10
- package/dist/runtime/component/decorators.d.ts +6 -0
- package/dist/shared/env.d.ts +4 -0
- package/dist/shared/functions.d.ts +2 -1
- package/dist/shared/gen-function.d.ts +2 -7
- package/dist/shared/index.d.ts +1 -0
- package/dist/types/ast.d.ts +6 -0
- package/dist/types/ir.d.ts +31 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -19,6 +19,7 @@
|
|
|
19
19
|
- **🎨 强大模板**:基于 AST 的模板编译,支持条件渲染和列表渲染
|
|
20
20
|
- **⚡ 响应式系统**:高效的响应式数据绑定,自动追踪依赖
|
|
21
21
|
- **🧩 Web 组件**:原生 Web 组件支持,可自定义元素
|
|
22
|
+
- **🛡️ 安全可靠**:编译时模板固定,自动 HTML 转义,内置 XSS 防护机制
|
|
22
23
|
- **📦 插件系统**:灵活的插件扩展机制
|
|
23
24
|
- **🧪 测试完善**:完整的单元测试覆盖
|
|
24
25
|
- **🗺️ 路由支持**:内置路由系统,支持单页应用开发
|
|
@@ -28,6 +29,8 @@
|
|
|
28
29
|
- [快速开始指南](./docs/guide.md) - 从零开始学习 Solely
|
|
29
30
|
- [API 文档](./docs/api.md) - 完整的 API 参考
|
|
30
31
|
- [示例项目](./examples/) - 实际应用示例
|
|
32
|
+
- [安全机制说明](#安全机制) - 了解框架的 XSS 防护机制
|
|
33
|
+
- [安全演示](./examples/security-demo/) - 查看 XSS 防护实际效果
|
|
31
34
|
|
|
32
35
|
## 📦 安装
|
|
33
36
|
|
|
@@ -324,7 +327,46 @@ solely/
|
|
|
324
327
|
4. **路由系统**:支持单页应用的路由管理,包括路由定义、导航和组件挂载
|
|
325
328
|
5. **插件系统**:提供扩展机制,支持自定义功能
|
|
326
329
|
|
|
327
|
-
##
|
|
330
|
+
## �️ 安全机制
|
|
331
|
+
|
|
332
|
+
Solely 框架内置了多层安全防护机制,有效防止常见的 XSS(跨站脚本攻击):
|
|
333
|
+
|
|
334
|
+
### 编译时安全
|
|
335
|
+
|
|
336
|
+
- **模板编译时固定**:所有模板在构建阶段编译为中间表示(IR),运行时无法更改模板结构
|
|
337
|
+
- **无运行时解析**:不存在 `eval` 或动态模板解析,杜绝代码注入
|
|
338
|
+
|
|
339
|
+
### 自动 HTML 转义
|
|
340
|
+
|
|
341
|
+
- **文本插值自动转义**:使用 `{{ }}` 插值时,框架自动进行 HTML 实体编码
|
|
342
|
+
|
|
343
|
+
```html
|
|
344
|
+
<!-- 用户输入: <script>alert('XSS')</script> -->
|
|
345
|
+
<div>{{ $data.userInput }}</div>
|
|
346
|
+
<!-- 渲染结果: <script>alert('XSS')</script> -->
|
|
347
|
+
```
|
|
348
|
+
|
|
349
|
+
### 安全最佳实践
|
|
350
|
+
|
|
351
|
+
| ✅ 推荐做法 | ❌ 避免做法 |
|
|
352
|
+
|---|---|
|
|
353
|
+
| 使用 `{{ }}` 插值显示用户内容 | 将用户输入绑定到 `:innerHTML` |
|
|
354
|
+
| 对用户输入进行验证和清理 | 直接操作 DOM 插入不可信内容 |
|
|
355
|
+
| 使用 CSP (Content Security Policy) | 信任未经检验的第三方 API 数据 |
|
|
356
|
+
| 富文本使用白名单过滤 | 动态构造模板字符串 |
|
|
357
|
+
|
|
358
|
+
### 注意事项
|
|
359
|
+
|
|
360
|
+
⚠️ **如果框架支持 `:innerHTML` 指令**:
|
|
361
|
+
|
|
362
|
+
- 永远不要将用户输入绑定到 `:innerHTML`
|
|
363
|
+
- 永远不要将第三方 API 数据直接绑定到 `:innerHTML`
|
|
364
|
+
- 仅对完全可信的静态内容使用 `:innerHTML`
|
|
365
|
+
- 如需渲染富文本,请使用专门的富文本组件并进行白名单过滤
|
|
366
|
+
|
|
367
|
+
查看 [安全演示示例](./examples/security-demo/) 了解框架如何防护 XSS 攻击。
|
|
368
|
+
|
|
369
|
+
## � API 参考
|
|
328
370
|
|
|
329
371
|
### CustomElement 装饰器
|
|
330
372
|
|
|
@@ -933,6 +975,7 @@ beforeEach: (to, from) => {
|
|
|
933
975
|
- **待办事项示例** (`examples/todo/`) - 列表管理和状态示例
|
|
934
976
|
- **表单示例** (`examples/form/`) - 表单处理和验证示例
|
|
935
977
|
- **天气示例** (`examples/weather/`) - 异步数据获取示例
|
|
978
|
+
- **安全演示** (`examples/security-demo/`) - XSS 防护机制演示
|
|
936
979
|
|
|
937
980
|
### 运行示例
|
|
938
981
|
|