0Pricing
NestJS Enterprise Backend APIs · レッスン

条件付きバリデーションと動的グループ

@ValidateIfとエンドポイントごとのバリデーショングループを使って、コンテキストに応じたルールを適用します。

「条件付きバリデーションと動的グループ」はCoddyKit上の無料NestJS Enterprise Backend APIsレッスンです。 これはレッスン4/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはNestJS Enterprise Backend APIs学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 NestJS Enterprise Backend APIsコースには全4レッスンが含まれています。

このレッスンの一部はまだ翻訳されておらず、英語で表示されています。

Why Conditional Validation?

Real enterprise endpoints rarely need the same rules on every request. A field can be required in one situation and forbidden in another. Two tools in class-validator solve this:

  • @ValidateIf — runs (or skips) a property's validators based on a condition computed from the object itself.
  • Validation groups — named sets of constraints, activated per call so one DTO can serve multiple endpoints.

This lesson shows how to combine both to keep a single DTO authoritative across create, update, and role-specific flows.

The Core Idea Behind @ValidateIf

@ValidateIf(cb) takes a callback (object, value) => boolean. When it returns false, class-validator ignores all other decorators on that property — including @IsNotEmpty and even @IsOptional. When it returns true, validation proceeds normally.

Think of it as a runtime switch placed in front of the property's constraint chain.

import { ValidateIf, IsNotEmpty, IsString } from 'class-validator';

export class PaymentDto {
  @IsString()
  method: 'card' | 'invoice';

  // cardToken is validated ONLY when method === 'card'
  @ValidateIf((o: PaymentDto) => o.method === 'card')
  @IsNotEmpty()
  @IsString()
  cardToken?: string;
}

@ValidateIf vs @IsOptional

These two look similar but differ in intent:

  • @IsOptional — skips validation when the value is null or undefined, unconditionally.
  • @ValidateIf — skips (or enables) validation based on any condition you write, including other fields.

Crucially, @ValidateIf returning false also suppresses errors even when a value is present. Use it when the presence requirement itself depends on context.

Forbidding a Field Conditionally

You can flip the logic: require a field to be absent under a condition. Combine @ValidateIf with @IsEmpty so the field is rejected when it should not appear.

Here, a discountCode is only allowed for promo orders; supplying it on a standard order fails validation.

import { ValidateIf, IsEmpty, IsString, IsIn } from 'class-validator';

export class OrderDto {
  @IsIn(['standard', 'promo'])
  type: 'standard' | 'promo';

  // Must be EMPTY unless this is a promo order
  @ValidateIf((o: OrderDto) => o.type !== 'promo')
  @IsEmpty({ message: 'discountCode is only allowed on promo orders' })
  discountCode?: string;
}

Introducing Validation Groups

A validation group is just a string label attached to a decorator via its options. Constraints with no group always run; constraints assigned to a group run only when that group is requested at validation time.

This lets one DTO express different rule sets — e.g. stricter rules at create than at update — without duplicating the class.

import { IsString, MinLength, IsNotEmpty } from 'class-validator';

export const CREATE = 'create';
export const UPDATE = 'update';

export class ProfileDto {
  @IsNotEmpty({ groups: [CREATE] })
  @IsString({ groups: [CREATE, UPDATE] })
  @MinLength(2, { groups: [CREATE, UPDATE] })
  displayName?: string;
}

Activating a Group

Groups do nothing until you pass them to the validator. With the imperative API you supply { groups: [...] } to validate(). In NestJS you forward the same option through the ValidationPipe.

Important default: when you request a group, constraints that belong to no group are still applied unless you set strictGroups or always options.

import { validate } from 'class-validator';
import { ProfileDto, UPDATE } from './profile.dto';

async function run() {
  const dto = Object.assign(new ProfileDto(), { displayName: '' });

  // Only UPDATE-group constraints (plus groupless ones) run.
  const errors = await validate(dto, { groups: [UPDATE] });
  console.log('error count:', errors.length);
}
run();

Wiring Groups into a NestJS Pipe

NestJS exposes validation-group options on ValidationPipe. The cleanest pattern is a per-route pipe whose groups declare which rule set this endpoint enforces.

Set always: true if you want groupless constraints to keep running regardless of the active group, and strictGroups: true to reject constraints whose group was not requested.

import { Controller, Post, Body, ValidationPipe } from '@nestjs/common';
import { ProfileDto, CREATE } from './profile.dto';

@Controller('profiles')
export class ProfileController {
  @Post()
  create(
    @Body(new ValidationPipe({ groups: [CREATE], always: true }))
    dto: ProfileDto,
  ) {
    return { ok: true, dto };
  }
}

One DTO, Two Endpoints

The payoff: a single DTO drives both POST (create) and PATCH (update) with different strictness. Each route binds its own ValidationPipe with the matching group.

Avoid the temptation to keep separate CreateDto and UpdateDto when only required-ness differs — groups remove that duplication and keep field types in one place.

import { Controller, Post, Patch, Body, ValidationPipe } from '@nestjs/common';
import { ProfileDto, CREATE, UPDATE } from './profile.dto';

@Controller('profiles')
export class ProfileController {
  @Post()
  create(@Body(new ValidationPipe({ groups: [CREATE] })) dto: ProfileDto) {
    return dto;
  }

  @Patch(':id')
  update(@Body(new ValidationPipe({ groups: [UPDATE] })) dto: ProfileDto) {
    return dto;
  }
}

Dynamic Groups from Request Context

Sometimes the group depends on runtime data — the caller's role, a feature flag, a tenant tier. Since the ValidationPipe instance is built at route-declaration time, derive the group inside a small custom pipe that reads the request, then call validate yourself with the computed groups.

import { Injectable, PipeTransform, BadRequestException } from '@nestjs/common';
import { plainToInstance } from 'class-transformer';
import { validate } from 'class-validator';
import { REQUEST } from '@nestjs/core';
import { Inject, Scope } from '@nestjs/common';

@Injectable({ scope: Scope.REQUEST })
export class RoleAwareValidationPipe implements PipeTransform {
  constructor(@Inject(REQUEST) private readonly req: any) {}

  async transform(value: any, meta: any) {
    const groups = this.req.user?.role === 'admin' ? ['admin'] : ['user'];
    const dto = plainToInstance(meta.metatype, value);
    const errors = await validate(dto, { groups, always: true });
    if (errors.length) throw new BadRequestException(errors);
    return dto;
  }
}

Combining @ValidateIf With Groups

The two mechanisms compose. @ValidateIf handles within-payload dependencies (field A depends on field B); groups handle which endpoint/role is calling. A constraint runs only when its group is active and its @ValidateIf condition holds.

Below, cancelReason is required — but only in the cancel group and only when the status is actually being set to cancelled.

import { ValidateIf, IsNotEmpty, IsIn } from 'class-validator';

export const CANCEL = 'cancel';

export class UpdateBookingDto {
  @IsIn(['active', 'cancelled'], { groups: [CANCEL] })
  status: 'active' | 'cancelled';

  @ValidateIf((o: UpdateBookingDto) => o.status === 'cancelled', { groups: [CANCEL] })
  @IsNotEmpty({ groups: [CANCEL] })
  cancelReason?: string;
}

Pure Logic You Can Verify

Strip away the framework and the decision is just predicate logic: a constraint fires when its group is requested and its condition is true. The function below mirrors how class-validator decides whether to enforce a single constraint, so you can reason about edge cases without a server.

type Ctx = { activeGroups: string[]; obj: Record<string, unknown> };

function shouldValidate(
  constraintGroups: string[],
  validateIf: (o: Record<string, unknown>) => boolean,
  ctx: Ctx,
): boolean {
  const groupMatches =
    constraintGroups.length === 0 ||
    constraintGroups.some((g) => ctx.activeGroups.includes(g));
  return groupMatches && validateIf(ctx.obj);
}

const ctx: Ctx = { activeGroups: ['cancel'], obj: { status: 'cancelled' } };
const fires = shouldValidate(['cancel'], (o) => o.status === 'cancelled', ctx);
console.log('cancelReason enforced?', fires); // true

const skip = shouldValidate(['create'], () => true, ctx);
console.log('create-only rule enforced?', skip); // false

Quick Check

Consider this property decorated with @ValidateIf.

Recap

You learned to make validation context-aware in NestJS:

  • @ValidateIf(cb) enables or fully skips a property's constraint chain based on a runtime predicate over the payload — ideal for inter-field dependencies.
  • Validation groups label constraints so one DTO serves multiple endpoints/roles; activate them via ValidationPipe({ groups }).
  • Tune behavior with always (groupless rules still run) and strictGroups (reject unrequested-group constraints).
  • For dynamic groups from request context (role, tenant), use a request-scoped pipe that computes groups and calls validate directly.
  • The mechanisms compose: a constraint fires only when its group is active and its @ValidateIf condition is true.

よくある質問

「条件付きバリデーションと動的グループ」レッスンは無料ですか？

はい。「条件付きバリデーションと動的グループ」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、NestJS Enterprise Backend APIsコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 NestJS Enterprise Backend APIsコースには全4レッスンが含まれています。

「条件付きバリデーションと動的グループ」で何を学びますか？

@ValidateIfとエンドポイントごとのバリデーショングループを使って、コンテキストに応じたルールを適用します。 ブラウザで直接実行するハンズオンコードでNestJS Enterprise Backend APIsを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

NestJS Enterprise Backend APIsを始めるのに経験は必要ですか？

事前経験は必要ありません。CoddyKitのNestJS Enterprise Backend APIsは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン4/4です。

「条件付きバリデーションと動的グループ」レッスンにはどのくらい時間がかかりますか？

ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このNestJS Enterprise Backend APIsレッスンでコードを書いて実行できますか？

はい。すべてのNestJS Enterprise Backend APIsレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

  1. ネストしたDTOと配列のValidation
  2. カスタムValidatorと非同期Constraint
  3. ClassSerializerInterceptorによるレスポンス整形
  4. 条件付きバリデーションと動的グループ
← NestJS Enterprise Backend APIsに戻る