@Body

NestJS 🟢 Junior

Définition

Décorateur de paramètre qui extrait le corps de la requête HTTP et le mappe sur un DTO. Peut cibler une propriété spécifique avec @Body('key'). Depuis NestJS 12.0.0, @Body() accepte aussi une option schema compatible Standard Schema (Zod, Valibot, ArkType), validée par StandardSchemaValidationPipe, en complément du flux class-validator historique.

Analogie

Comme ouvrir un colis et en extraire le contenu pour le traiter.

Exemple de code

@Post()
create(@Body() dto: CreateUserDto) {
  return this.userService.create(dto);
}

@Post('login')
login(@Body('email') email: string) {
  return this.authService.login(email);
}

Cas d'usage

Recevoir les données envoyées par le client dans les requêtes POST, PUT ou PATCH.

Termes liés

#core#interview#nest12

En entretien

Explique-moi le décorateur @Body.
C'est un décorateur de paramètre qui extrait le corps de la requête HTTP et le mappe sur un DTO ; il peut aussi cibler une propriété spécifique avec @Body('key'). On l'utilise pour recevoir les données envoyées par le client dans les requêtes POST, PUT ou PATCH.
Qu'apporte NestJS 12.0.0 à @Body ?
@Body() accepte désormais aussi une option schema compatible Standard Schema (Zod, Valibot, ArkType), validée par StandardSchemaValidationPipe, en complément du flux class-validator historique. Ça permet de valider le corps de la requête avec d'autres bibliothèques que class-validator.

Sources

github.com/nestjs/nest/releases/tag/v12.0.0

Fiche mise à jour le 2026-09-27