一句话TypeGraphQL 是一个用于 Node.js/TypeScript 的现代 GraphQL API 开发框架,通过类与装饰器定义 Schema、类型和 Resolver。
定价开源免费,社区赞助支持 项目采用 MIT 许可证开源;正文提到可通过 GitHub Sponsors 支持,Gold Sponsor 可获得核心贡献者提供的 premium technical support,但未给出具体价格。
适合谁使用 Node.js、TypeScript 构建 GraphQL API 的后端开发者和团队,尤其是希望减少 SDL、ORM 实体和 TypeScript 接口重复维护的项目。
核心功能使用 TypeScript 类和装饰器定义 GraphQL Schema支持类型、接口、枚举、联合类型和订阅将查询、变更和字段解析器实现为类方法支持依赖注入和请求级 Scoped Container集成 class-validator 进行输入参数校验支持授权守卫、中间件、自定义装饰器和查询复杂度控制可生成 schema.graphql SDL 文件可与 TypeORM、sequelize-typescript、Typegoose、Prisma、NestJS 等生态集成
功能与用途用于在 Node.js 中使用 TypeScript 构建 GraphQL API。核心方式是通过类和装饰器定义整个 GraphQL Schema,包括类型、接口、枚举、联合类型和订阅,并将 Query、Mutation、Field Resolver 实现为普通类方法。还提供自动校验、授权守卫、依赖注入、中间件、自定义装饰器、查询复杂度控制和 SDL 导出等能力。
支持语言/框架面向 Node.js 与 TypeScript;支持 GraphQL。正文示例和文档提到与 Apollo Server、GraphQL Yoga、express-graphql、AWS Lambda、Azure Functions、NestJS、Prisma、TypeORM、MikroORM、Typegoose、sequelize-typescript 等集成或使用场景。
开源还是闭源MIT-licensed open source project,社区支持的开源项目。
自托管选项作为 npm/Node.js 库集成到用户自己的 GraphQL 服务中运行,可在本地服务器、Apollo Server、GraphQL Yoga、AWS Lambda、Azure Functions 等环境中部署;正文未描述托管云服务。
定价免费开源。正文提到可通过 GitHub Sponsors 赞助项目,Gold Sponsor 可获得核心贡献者的 premium technical support,但未提供具体价格。
API/SDK提供 type-graphql 包及 TypeScript 装饰器/API,例如 @ObjectType、@Field、@Resolver、@Query、@Mutation、@Arg、@InputType、buildSchema、emitSchemaDefinitionFile、GraphQLISODateTime、GraphQLTimestamp 等。
集成与生态可与 decorator-based 库和 GraphQL/Node 生态集成,包括 TypeORM、sequelize-typescript、Typegoose、MikroORM、Prisma、NestJS、Apollo Federation、Apollo Cache Control、GraphQL Scalars、TSyringe、TypeDI、InversifyJS、injection-js、Redis 订阅示例等。
文档质量文档结构较完整,覆盖 Introduction、Getting started、Examples、Installation、Types and Fields、Resolvers、Bootstrapping、迁移指南、高级指南、依赖注入、授权、校验、性能、FAQ、集成和云函数部署等;正文包含大量代码示例和问题排查说明。
中国访问未知
适用场景构建 Node.js TypeScript GraphQL API;以代码优先方式定义 Schema;结合 ORM 统一实体与 GraphQL 类型;需要输入校验、授权、依赖注入、订阅或 SDL 导出的后端服务。
同类Apollo Server、NestJS GraphQL、GraphQL Yoga、Mercurius、Nexus、Pothos GraphQL