SuperAPI AI 工具集

verify-email-snapshots

办公与效率

查看项目

更新于 10-16 01:28

技能介绍

用途:该技能提供一套在 .NET 单元测试中校验邮件快照的模式,用于测试邮件模板渲染是否与预期输出一致。适用于检测邮件模板回归、验证 MJML 模板编译为预期 HTML、在代码审查中审阅邮件改动(差异可视化)、确保变量替换正确。

主要能力:基于 Verify 快照测试捕获渲染后的 HTML。首次运行生成 .verified.html 基线文件,之后内容变化会导致测试失败并给出差异。支持对每个模板变体编写独立测试,支持清理动态值(如时间戳、GUID、带令牌 URL),支持组合器快照测试(校验主题、收件人、正文等完整邮件对象),并支持 CI 集成(缺少基线文件时报错)。

使用方式:安装包 dotnet add package Verify.Xunit(或 Verify.NUnit、Verify.MSTest)。编写测试,用渲染器渲染模板得到 HTML,然后调用 await Verify(html, extension: "html")。首次运行生成 .verified.html,需人工审查后提交。模板变化时测试失败,可用 diff 工具审查:dotnet tool install -g verify.tool、verify review、verify accept。接受变更前务必逐项审查。

限制与注意:该技能仅为测试模式说明,资料未提供具体收费或价格信息。不应在未审查的情况下自动接受变更(verify accept --all 有风险)。配合 MJML 模板作者技能、Mailpit 本地投递技能、通用 Verify 快照测试技能使用。

依赖与工具信息:资料提及 Verify(https://github.com/VerifyTests/Verify)、Verify.Xunit、DiffEngine,以及 MJML 模板渲染器接口 IMjmlTemplateRenderer 与组合器接口 IUserEmailComposer;其余实现细节暂未提供。