Validation with Joi in NestJS - Step-by-Step Execution

Concept Flow - Validation with Joi

Define Joi Schema

↓

Receive Input Data

↓

Validate Data Against Schema

↓

Proceed

This flow shows how Joi schema is defined, input data is validated, and based on validation result, either proceeds or returns an error.

Execution Sample

NestJS

import * as Joi from 'joi';

const schema = Joi.object({
  name: Joi.string().min(1).required(),
  age: Joi.number().min(0)
});

const result = schema.validate({ name: 'Alice', age: 25 });

This code defines a Joi schema for an object with name and age, then validates an input object against it.

Execution Table

Step	Action	Input Data	Validation Result	Error Message
1	Define schema	N/A	Schema created	None
2	Validate input {name: 'Alice', age: 25}	{name: 'Alice', age: 25}	Valid	None
3	Validate input {name: '', age: -5}	{name: '', age: -5}	Invalid	"name" length must be at least 1 character long, "age" must be larger than or equal to 0
4	Validate input {age: 30}	{age: 30}	Invalid	"name" is required

💡 Validation stops after checking all required fields and constraints.

Variable Tracker

Variable	Start	After Step 2	After Step 3	After Step 4
schema	undefined	Joi schema object	Joi schema object	Joi schema object
inputData	undefined	{name: 'Alice', age: 25}	{name: '', age: -5}	{age: 30}
validationResult	undefined	valid: true	valid: false	valid: false
errorMessage	undefined	none	"name" length must be at least 1 character long, "age" must be larger than or equal to 0	"name" is required

Key Moments - 3 Insights

Why does validation fail when name is an empty string?

Because the schema requires name to be a non-empty string (see execution_table step 3), empty string violates the .min(1) rule.

What happens if a required field is missing in input?

Validation fails with an error message indicating the missing field (see execution_table step 4 where name is missing).

Does Joi stop validation after first error?

No, Joi reports all validation errors found in the input at once, as shown in step 3 where both name and age errors appear.

Visual Quiz - 3 Questions

Look at the execution_table, what is the validation result at step 2?

A Invalid

B Valid

C Error thrown

D Schema undefined

💡 Hint

Check the 'Validation Result' column at step 2 in execution_table.

At which step does the error message mention that "name" is required?

A Step 4

B Step 2

C Step 3

D None

💡 Hint

Look at the 'Error Message' column for step 4 in execution_table.

If inputData changes to {name: 'Bob', age: -1}, what validation error would appear?

A No errors

B "name" is required

C "age" must be larger than or equal to 0

D "name" is not allowed to be empty

💡 Hint

Refer to the age validation rule and error messages in execution_table step 3.

Concept Snapshot

Joi Validation Quick Guide:
- Define schema with Joi.object({field: Joi.type().rules()})
- Use schema.validate(data) to check input
- Validation returns {value, error}
- Errors list all issues found
- Required fields must be present and valid
- Use in NestJS pipes for request validation

Full Transcript

This visual execution trace shows how to use Joi for validation in NestJS. First, a Joi schema is defined specifying required fields and rules. Then input data is validated against this schema. The validation result can be valid or invalid. If invalid, Joi returns detailed error messages listing all problems found. For example, empty strings for required fields or negative numbers for fields with minimum constraints cause validation to fail. The variable tracker shows how schema, input data, validation results, and error messages change step-by-step. Key moments clarify common confusions like why empty strings fail or how missing fields cause errors. The quiz tests understanding by referencing specific steps and error messages. This helps beginners see exactly how Joi validation works in practice.

Practice

1. What is the main purpose of using Joi in a NestJS application?

easy

A. To style the user interface

B. To manage database connections

C. To handle HTTP routing

D. To validate and enforce rules on incoming data

Solution

1. Step 1: Understand Joi's role

   Joi is a library used to define schemas that describe how data should look and to check if data matches those rules.

2. Step 2: Identify the correct purpose in NestJS

   In NestJS, Joi is used to validate incoming data to ensure it meets expected formats and constraints before processing.

3. Final Answer:

   To validate and enforce rules on incoming data -> Option D

4. Quick Check:

   Joi = Data validation [OK]

Hint: Joi is for checking data shapes and rules [OK]

Common Mistakes:

• Confusing Joi with database or routing tools
• Thinking Joi styles UI elements
• Assuming Joi manages server configuration

2. Which of the following is the correct way to define a Joi schema for a required string field named username?

easy

A. Joi.string().required()

B. Joi.number().required()

C. Joi.boolean().optional()

D. Joi.array().required()

Solution

1. Step 1: Identify the data type for username

   A username is typically a string, so the schema should start with Joi.string().

2. Step 2: Make the field required

   Adding .required() ensures the field must be present and not empty.

3. Final Answer:

   Joi.string().required() -> Option A

4. Quick Check:

   String + required = Joi.string().required() [OK]

Hint: Use Joi.string().required() for mandatory text fields [OK]

Common Mistakes:

• Using wrong Joi types like number or boolean for strings
• Forgetting to add .required() for mandatory fields
• Confusing optional() with required()

3. Given this Joi schema:

const schema = Joi.object({ age: Joi.number().min(18).required() });
const result = schema.validate({ age: 16 });

What will result.error contain?

medium

A. No error, validation passes

B. An error indicating age must be at least 18

C. An error indicating age is missing

D. An error indicating age must be a string

Solution

1. Step 1: Analyze the schema rules

   The schema requires age to be a number, at least 18, and required.

2. Step 2: Check the input data

   The input has age: 16, which is less than the minimum 18.

3. Step 3: Determine validation result

   Validation fails because 16 is below the minimum, so result.error contains a message about age being too low.

4. Final Answer:

   An error indicating age must be at least 18 -> Option B

5. Quick Check:

   Age 16 < 18 = validation error [OK]

Hint: Check min() rules against input values [OK]

Common Mistakes:

• Assuming 16 passes min(18) validation
• Confusing missing field error with min value error
• Expecting string type error instead of number

4. Identify the error in this Joi schema definition:

const schema = Joi.object({
  email: Joi.string().email,
  password: Joi.string().min(8).required()
});

medium

A. email should be Joi.email() instead of Joi.string().email

B. password should not be required

C. Missing parentheses after email() method

D. min(8) is invalid for strings

Solution

1. Step 1: Review the email field syntax

   The email method in Joi is a function and must be called with parentheses: email().

2. Step 2: Identify the missing parentheses

   The code uses Joi.string().email without parentheses, which is incorrect and will cause an error.

3. Final Answer:

   Missing parentheses after email() method -> Option C

4. Quick Check:

   Joi methods require () to execute [OK]

Hint: Always add () after Joi methods like email() [OK]

Common Mistakes:

• Omitting parentheses on Joi method calls
• Misunderstanding required() necessity
• Thinking min() is invalid for strings

5. You want to validate a user object with name (required string), age (optional number, minimum 0), and email (required valid email). Which Joi schema correctly applies these rules?

hard

A. Joi.object({ name: Joi.string().required(), age: Joi.number().min(0), email: Joi.string().email().required() })

B. Joi.object({ name: Joi.string(), age: Joi.number().min(0).required(), email: Joi.string().email() })

C. Joi.object({ name: Joi.string().required(), age: Joi.number().min(1).optional(), email: Joi.string().email().required() })

D. Joi.object({ name: Joi.string().required(), age: Joi.number().min(0).required(), email: Joi.string().email().required() })

Solution

1. Step 1: Check each field's requirements

   Name must be a required string, age is optional number with min 0, email is required valid email string.

2. Step 2: Match schema to requirements

   Joi.object({ name: Joi.string().required(), age: Joi.number().min(0), email: Joi.string().email().required() }) matches all: name is required string, age is number with min 0 (optional by default), email is required email string.

3. Step 3: Verify other options

   Joi.object({ name: Joi.string(), age: Joi.number().min(0).required(), email: Joi.string().email() }) makes age required and email optional, Joi.object({ name: Joi.string().required(), age: Joi.number().min(1).optional(), email: Joi.string().email().required() }) uses min(1) for age (wrong min), Joi.object({ name: Joi.string().required(), age: Joi.number().min(0).required(), email: Joi.string().email().required() }) makes age required (wrong).

4. Final Answer:

   Joi.object({ name: Joi.string().required(), age: Joi.number().min(0), email: Joi.string().email().required() }) -> Option A

5. Quick Check:

   Required fields + optional age min 0 = Joi.object({ name: Joi.string().required(), age: Joi.number().min(0), email: Joi.string().email().required() }) [OK]

Hint: Required fields use .required(), optional omit it [OK]

Common Mistakes:

• Making optional fields required by mistake
• Using wrong min values for age
• Forgetting to call email() with parentheses