Why Injectable decorator in NestJS? - Purpose & Use Cases

The Big Idea

Discover how a simple decorator can save you from tangled, buggy code!

The Scenario

Imagine building a large app where you have to create and manage every service and its dependencies by hand.

Every time you want to use a service inside another, you must manually create instances and pass them around.

The Problem

This manual approach quickly becomes messy and error-prone.

You might accidentally create multiple instances of the same service, causing inconsistent data.

It's hard to track who needs what, and changing one service means updating many places.

The Solution

The Injectable decorator in NestJS marks a class as a service that can be automatically created and shared.

It lets NestJS handle creating and providing the right instances wherever needed.

This makes your code cleaner, easier to maintain, and less buggy.

Before vs After

✗ Before

const service = new Service();
const controller = new Controller(service);

✓ After

@Injectable()
class Service {}

@Injectable()
class Controller {
  constructor(private readonly service: Service) {}
}

What It Enables

It enables automatic and consistent sharing of services across your app without manual wiring.

Real Life Example

Think of a user authentication service that many parts of your app need.

With @Injectable(), you write it once, and NestJS provides the same instance everywhere it's needed.

Key Takeaways

Manually managing service instances is hard and error-prone.

@Injectable() marks classes for automatic creation and sharing.

This leads to cleaner, more maintainable, and reliable code.

Practice

1. What is the main purpose of the @Injectable() decorator in NestJS?

easy

A. To style components with CSS

B. To define a route handler in a controller

C. To create a database connection automatically

D. To mark a class so NestJS can manage it for dependency injection

Solution

1. Step 1: Understand the role of @Injectable()

   This decorator tells NestJS that the class can be injected as a dependency, making it reusable and manageable by the framework.

2. Step 2: Differentiate from other decorators

   Other decorators like @Controller() or database decorators serve different purposes, not dependency injection.

3. Final Answer:

   To mark a class so NestJS can manage it for dependency injection -> Option D

4. Quick Check:

   @Injectable() = marks class for DI [OK]

Hint: Remember: @Injectable() means NestJS manages the class [OK]

Common Mistakes:

• Confusing @Injectable() with @Controller()
• Thinking it creates routes or database connections
• Assuming it styles components

2. Which of the following is the correct syntax to make a service class injectable in NestJS?

easy

A. function Injectable() { return class MyService {} }

B. class MyService {}

C. @Injectable() class MyService {}

D. @Injectable class MyService {}

Solution

1. Step 1: Recall correct decorator syntax

   In NestJS, decorators are functions called with parentheses, so @Injectable() is correct.

2. Step 2: Check each option

   class MyService {} lacks the decorator. function Injectable() { return class MyService {} } is invalid syntax. @Injectable class MyService {} misses parentheses after @Injectable.

3. Final Answer:

   @Injectable() class MyService {} -> Option C

4. Quick Check:

   Decorator syntax requires parentheses () [OK]

Hint: Always use parentheses with decorators like @Injectable() [OK]

Common Mistakes:

• Omitting parentheses after @Injectable
• Trying to use @Injectable without decorator syntax
• Confusing class and function syntax

3. Given the following code, what will be the output when appService.getMessage() is called?

import { Injectable } from '@nestjs/common';

@Injectable()
class AppService {
  getMessage() {
    return 'Hello from AppService';
  }
}

const appService = new AppService();
console.log(appService.getMessage());

medium

A. Hello from AppService

B. undefined

C. Error: AppService is not injectable

D. null

Solution

1. Step 1: Understand @Injectable() effect on class instantiation

   The @Injectable() decorator marks the class for NestJS DI but does not change normal instantiation behavior.

2. Step 2: Analyze the code execution

   The code creates an instance manually and calls getMessage(), which returns the string as expected.

3. Final Answer:

   Hello from AppService -> Option A

4. Quick Check:

   Manual instantiation still works; method returns string [OK]

Hint: Manual new works; decorator doesn't block normal class use [OK]

Common Mistakes:

• Assuming decorator breaks manual instantiation
• Expecting an error without NestJS container
• Thinking method returns undefined

4. Identify the error in this NestJS service code:

import { Injectable } from '@nestjs/common';

@Injectable
export class UserService {
  getUser() {
    return 'User data';
  }
}

medium

A. Missing parentheses after @Injectable decorator

B. Class name should be lowercase

C. Method getUser must be async

D. Missing export keyword

Solution

1. Step 1: Check decorator syntax

   The @Injectable decorator must be called with parentheses: @Injectable().

2. Step 2: Verify other code parts

   Class name casing is correct by convention. Method need not be async. Export keyword is present.

3. Final Answer:

   Missing parentheses after @Injectable decorator -> Option A

4. Quick Check:

   Decorator requires () to work properly [OK]

Hint: Always add () after decorators like @Injectable() [OK]

Common Mistakes:

• Forgetting parentheses after decorator
• Thinking method must be async
• Confusing export keyword presence

5. You want to create a reusable logging service in NestJS that other services can inject. Which of the following is the best way to define it?

hard

A. Create a class without @Injectable() and instantiate it manually everywhere

B. Use @Injectable() on the logging class and inject it where needed

C. Define logging functions in a plain JavaScript object and export it

D. Use @Controller() decorator on the logging class

Solution

1. Step 1: Understand dependency injection benefits

   Using @Injectable() allows NestJS to manage the logging service lifecycle and inject it automatically where needed.

2. Step 2: Evaluate options for reusability and testability

   Manual instantiation loses DI benefits. Plain objects lack lifecycle and DI. @Controller() is for routing, not services.

3. Final Answer:

   Use @Injectable() on the logging class and inject it where needed -> Option B

4. Quick Check:

   Injectable services = reusable and testable [OK]

Hint: Always use @Injectable() for reusable NestJS services [OK]

Common Mistakes:

• Skipping @Injectable() and instantiating manually
• Using @Controller() for services
• Using plain objects without DI benefits