NestJS memiliki dukungan GraphQL tingkat pertama melalui @nestjs/graphql (dibangun di atas Apollo Server). Ini menawarkan pendekatan code-first (definisikan skema Anda dengan kelas TypeScript dan dekorator, skema di-generate secara otomatis) — cara idiomatis NestJS — sesuai dengan model dekorator/DI framework.
({
: [
.<>({
: ,
: ,
: ,
}),
],
})
{}
@ObjectType() // a GraphQL type
export class User {
@Field(() => ID) id: string;
@Field() name: string;
@Field() email: string;
@Field(() => [Post]) posts: Post[]; // related type
}
Dalam code-first, kelas yang didekorasi (@ObjectType, @Field) mendefinisikan skema — tipe TypeScript menghasilkan skema GraphQL secara otomatis, menjaganya tetap sinkron.
@Resolver(() => User)
export class UsersResolver {
constructor(private usersService: UsersService) {} // DI works as usual
@Query(() => [User]) // a query: returns a list of users
users() {
return this.usersService.findAll();
}
@Query(() => User)
user(@Args("id") id: string) { // query with an argument
return this.usersService.findOne(id);
}
@Mutation(() => User) // a mutation: creates a user
createUser(@Args("input") input: CreateUserInput) {
return this.usersService.create(input);
}
}
Resolver (seperti controller, tetapi untuk GraphQL) mendefinisikan handler @Query dan @Mutation, mendelegasikan ke service melalui DI — pola yang sama seperti controller REST.
@ResolveField(() => [Post]) // resolve User.posts on demand
posts(@Parent() user: User) {
return this.postsService.findByUser(user.id);
}
// ⚠️ for lists, this can cause N+1 queries → use DataLoader to BATCH them
@ResolveField menyelesaikan field yang terkait/bersarang secara lazy — tetapi untuk list, ini berisiko masalah query N+1, diselesaikan dengan batching DataLoader.
GraphQL: clients request EXACTLY the fields they need (no over/under-fetching),
one endpoint, strongly typed, great for complex/nested data & varied clients
REST: simpler, better HTTP caching, well-understood — fine for straightforward APIs
→ Choose based on needs, not hype. NestJS supports both equally well.
Dukungan GraphQL tingkat pertama NestJS berharga karena menghadirkan manfaat GraphQL — klien mengambil data yang mereka butuhkan (menghilangkan over- dan under-fetching), endpoint yang tipe-kuat tunggal, dan penanganan data kompleks/bersarang yang sangat baik — ke dalam model terstruktur NestJS yang familiar.
Pemahamannya penting untuk membangun API modern, terutama pendekatan idiomatis code-first (mendefinisikan skema dengan kelas TypeScript dan dekorator @ObjectType/@Field/@Resolver, dengan skema di-generate dan dijaga sinkron) yang cocok dengan arsitektur dekorator/DI NestJS secara alami — resolver bekerja seperti controller, mendelegasikan ke service yang di-inject.
Mengetahui cara mendefinisikan tipe, query, mutation, dan field yang di-resolve, dan menyadari masalah N+1 query (dan DataLoader sebagai solusi) untuk data bersarang, adalah pengetahuan tingkat senior yang penting.
Sama pentingnya adalah memahami trade-off GraphQL vs REST untuk memilih pendekatan yang tepat untuk proyek tertentu (GraphQL untuk kebutuhan data fleksibel, kompleks, multi-klien; REST untuk API yang lebih sederhana dengan caching HTTP yang kuat).
GraphQL adalah paradigma API utama, dan integrasi bersih NestJS menjadikannya kemampuan yang signifikan dan sering relevan untuk membangun back-end yang fleksibel dan efisien.