Twenty可同步实体集成测试编写
依据Twenty内核规范,为可同步元数据实体编写涵盖校验异常与CRUD操作的完整集成测试套件及测试工具。
功能与用途
本指南专门用于为开源CRM Twenty服务端开发中的可同步元数据实体(Syncable Entity)编写端到端集成测试。它遵循Twenty核心代码库标准的双文件架构(Query Factory查询工厂与Wrapper执行封装),指导开发者系统性地覆盖参数校验失败、转译异常、必填与选填字段创建、字段更新清理以及级联删除等场景,确保元数据迁移系统的稳定可靠。
适用场景
- 编写测试查询工具类:为新实体创建Query Factory和Wrapper函数,封装GraphQL请求与错误检查机制。
- 覆盖校验失败异常场景:通过参数化测试验证缺失必填项、重名冲突及非法外键等校验失败快照。
- 验证CRUD正向操作:编写实体创建、空格过滤、长文本处理、字段更新及最终资源清理的成功断言测试。
适用人群
- Twenty核心代码库贡献者
- Node.js/NestJS后端开发工程师
- TypeScript测试工程师
使用步骤
- 按照双文件模式在测试目录下创建CRUD对应的Query Factory和Wrapper工具
- 编写failing-*.integration-spec测试用例,覆盖输入校验与异常快照断
- 编写successful-*.integration-spec测试用例,覆盖边界数据处理与
- 运行Jest命令执行测试,生成并核对测试快照文件确保测试全部通过
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-28
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Contributing to the Twenty codebase itself (twentyhq/twenty server internals), not for building apps on top of Twenty. Create comprehensive integration tests for syncable entities in Twenty. Use when writing integration tests for metadata entities, covering validator exceptions, input transpilation errors, and CRUD operations. Tests are MANDATORY for all syncable entities.
依赖与权限
- 读取用户主动提供的内容