Yaya za ka gwaji NestJS aikace-aikace?

Question

Accepted Answer

NestJS yana ba da gida-gida **testing utility (`@nestjs/testing`)** haɗa da Jest, kuma **architecture gida-gida-injection-sa yana sanya gwaji tsantsan gaske** — ka aiki module gwaji kuma ka bugi jere don ijaphe. Gwajin suna cikin gwajin unit (keɓeɓɓe) da gwajin e2e (cikakken app).

## Gwajin service na unit (tare da jere na banga)

```ts
import { Test } from "@nestjs/testing";

describe("UsersService", () => {
  let service: UsersService;
  let mockRepo = { find: jest.fn(), save: jest.fn() };

beforeEach(async () => {
    const module = await Test.createTestingModule({
      providers: [
        UsersService,
        // inject a MOCK for the repository — no real database needed
        { provide: getRepositoryToken(User), useValue: mockRepo },
      ],
    }).compile();

service = module.get<UsersService>(UsersService);
  });

it("returns all users", async () => {
    mockRepo.find.mockResolvedValue([{ id: 1, name: "Ann" }]);
    const result = await service.findAll();
    expect(result).toHaveLength(1);
    expect(mockRepo.find).toHaveBeenCalled();
  });
});
```

Albarar gida: NestJS DI ya ba ka damar **musanya ijaphe gaske da jere** ta hanyar provider na module gwaji — don haka ka gwaji service a keɓe, ba tare da tunani-nunin gaske ko ayyukan waje ba.

## Buga jere da sauƙi

```ts
// provide a fake for ANY dependency by its token
{ provide: EmailService, useValue: { send: jest.fn() } }
{ provide: ConfigService, useValue: { get: () => "test-value" } }
```

Domin akela saba basu gina ijaphe nasu (DI ke yi haka), musanya jere ita ce aiki mai sauƙi — gida na gwajin tsantsan.

## Gwajin ƙarshe-zuwa-ƙarshe (e2e) — cikakken app akan HTTP

```ts
import * as request from "supertest";

describe("Users (e2e)", () => {
  let app: INestApplication;

beforeAll(async () => {
    const module = await Test.createTestingModule({
      imports: [AppModule],        // the whole app
    }).compile();
    app = module.createNestApplication();
    await app.init();
  });

it("GET /users", () => {
    return request(app.getHttpServer())   // make a real HTTP request
      .get("/users")
      .expect(200)
      .expect(res => expect(res.body).toBeInstanceOf(Array));
  });

afterAll(async () => await app.close());
});
```

**Gwajin E2E** yana buɗe cikakken aikace-aikace kuma yana yi bugun HTTP gaske (ta hanyar `supertest`), tabbatar da cikakken yanayi (routing → guards → pipes → handler → amsa) tare ya aiki.

## Dabarun gwaji

```text
Unit tests  → services, guards, pipes in isolation (mock dependencies) — fast, numerous
Integration → a controller + its real service together via the testing module
E2E tests   → full app over HTTP (supertest) — verify real request flows, fewer
Use a TEST database (or mocks) for e2e; override providers for external services.
```

## Me yasa ya amfani

Gwaji ita ce mahimmanci don aikace-aikace masu aminci, kuma architecture NestJS yana sanya shi tsantsan gaske — fahimtar yaya za ka gwaji ita ce mahimmanci duka don ingancin code kuma domin framework ashi *tsarawa* don gwaji.

Hankali na tsakiya shine cewa **injection gida-gida yana sanya jere aiki mai sauƙi**: domin akela saba suna bayyana ijaphe nasu kuma DI yana ba su, module `@nestjs/testing` ya ba ka damar musanya kowane ijaphe (tunani-nunin repositories, ayyukan waje, config) da jere ta toku, wajen saurin, keɓeɓɓen **gwajin unit** na ayyuka, guards, da pipes ba tare da gaske na bururi ba.

Wancan gwajin ita ce babbar dalili domin amintaccen DI-based frameworks kamar NestJS.

Danda da gwajin unit, **gwajin e2e** (buɓewa cikakken app kuma yi bugun HTTP gaske ta hanyar `supertest`) tabbatar cewa cikakken roba bugun — routing, guards, tabbatarwa, ayyuka — tare ya aiki jiya.

Sanin abubuwan gwaji (`Test.createTestingModule`, musanya provider don bugun jere), yaya za ka rubuta duka gwajin unit da e2e, da dabarun gwaji mai hankali (da yawa da saurin keɓeɓɓen gwajin unit, kaɗan cikakken gwajin e2e, tunani-nunin gwaji) ita ce alamar professional NestJS development.

Yana nuni da kyakkyawan ingancin gabatarwa kuma yana amfani gida-gida dalilin gida-gida NestJS structured, DI-driven design, wanda shi ke sanya mahimmanci senior-level topic.