# E2E Testing Guide {#e2e-testing-guide}


End-to-end testing for the Gauzy API.


## Setup {#setup}


E2E tests use **Jest** with **supertest** against a real running API:

```bash
# Run E2E tests
yarn test:e2e
```


## Writing E2E Tests {#writing-e2e-tests}


```typescript
import { Test, TestingModule } from "@nestjs/testing";
import { INestApplication } from "@nestjs/common";
import * as request from "supertest";
import { AppModule } from "../src/app.module";

describe("EmployeeController (E2E)", () => {
  let app: INestApplication;
  let authToken: string;

  beforeAll(async () => {
    const module: TestingModule = await Test.createTestingModule({
      imports: [AppModule],
    }).compile();

    app = module.createNestApplication();
    await app.init();

    // Login to get auth token
    const loginRes = await request(app.getHttpServer())
      .post("/api/auth/login")
      .send({ email: "admin@ever.co", password: "admin" });
    authToken = loginRes.body.token;
  });

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

  describe("GET /api/employee", () => {
    it("should return paginated list", () => {
      return request(app.getHttpServer())
        .get("/api/employee")
        .set("Authorization", `Bearer ${authToken}`)
        .expect(200)
        .expect((res) => {
          expect(res.body.items).toBeDefined();
          expect(res.body.total).toBeGreaterThanOrEqual(0);
        });
    });

    it("should return 401 without auth", () => {
      return request(app.getHttpServer()).get("/api/employee").expect(401);
    });
  });

  describe("POST /api/employee", () => {
    it("should create an employee", async () => {
      const res = await request(app.getHttpServer())
        .post("/api/employee")
        .set("Authorization", `Bearer ${authToken}`)
        .send({
          user: { firstName: "Test", lastName: "User", email: "test@ever.co" },
          startedWorkOn: new Date().toISOString(),
        })
        .expect(201);

      expect(res.body.id).toBeDefined();
    });
  });
});
```


## Test Database {#test-database}


E2E tests use a separate test database:

```env
# .env.test
DB_TYPE=sqlite
DB_NAME=gauzy-test.sqlite3
```


## Test Lifecycle {#test-lifecycle}






```mermaid
graph LR
    Setup[Setup Test DB] --> Seed[Seed Data]
    Seed --> Run[Run Tests]
    Run --> Assert[Assert Results]
    Assert --> Cleanup[Cleanup DB]
```






## Best Practices {#best-practices}


- Use a separate test database
- Seed minimal required data
- Clean up after each test suite
- Test both success and error paths
- Test authentication and authorization


## Related Pages {#related-pages}


- [Unit Testing Guide](https://sourcey-gauzy.pages.dev/testing/unit-testing/index.md) — unit tests
- [API Integration Testing](https://sourcey-gauzy.pages.dev/testing/api-integration-testing/index.md) — API testing
- [CI Test Pipeline](https://sourcey-gauzy.pages.dev/testing/ci-test-pipeline/index.md) — CI integration