sagetest

KO | EN

gitlite — search

#hacktoberfest #react #llm #go #android #linux #docker #nodejs #cli #kubernetes #vue #security #mcp #openai

(★ 9)

🧪 Neat and streamlined library for testing node.js HTTP servers.

sagetest Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img src="misc/logo.png">

<hr>

 Neat and streamlined testing library for node.js HTTP servers powered by <a href="https://github.com/nodejs/undici">undici</a>.


 It's currently in alpha. Everything could be a breaking change until the first major version.


 <a href="https://eddienubes.github.io/sagetest/">Documentation</a> | <a href="https://eddienubes.github.io/sagetest/getting-started/introduction/">Getting Started</a>


 <a href="https://www.npmjs.com/package/sagetest"><img src="https://img.shields.io/npm/v/sagetest?color=729B1B&label=npm"/></a>
 <a href="https://github.com/eddienubes/sagetest/actions/workflows/ci.yml"><img src="https://github.com/eddienubes/sagetest/actions/workflows/ci.yml/badge.svg?branch=main"/></a>
 <a href="https://codecov.io/gh/eddienubes/sagetest" ><img src="https://codecov.io/gh/eddienubes/sagetest/graph/badge.svg?token=UFSWU4BEEB"/></a>

## 🌟 Features

- Yes! This is a reference to my favourite Valorant character, Sage.
- **TypeScript friendly**, exposes both ESM and CJS modules.
- Built on top of [undici](https://github.com/nodejs/undici) for **maximum performance**.
- Provides **easy-to-use**, supertest-like API.
- Supports a **dedicated test server** to reduce the number of instances spawned during testing.
- Supports **Node.js v20.0 and above**.
- **No unnecessary** third-party dependencies.
- Automatically handles **cookie parsing**.

## 🚀 Getting Started

```sh
npm install -D sagetest
yarn add -D sagetest
pnpm add -D sagetest
```

## 🎬 Sagetest in action

> There are several other methods which you can find in the [API documentation](https://eddienubes.github.io/sagetest/).
> In general, the usage experience should resemble that of supertest.

#### Express Endpoint Testing

Example usage of **auth** method to set Basic Auth header based on username and password.

```ts
import { request } from '../src/index.js';

// Just a plain express app
const response = await request(app).get('/').auth('user', 'pass');

expect(response).toEqual({
  body: {
    message: 'I love my mom!',
    requestHeaders: {
      authorization: 'Basic dXNlcjpwYXNz',
      connection: 'close',
      host: expect.stringContaining('localhost')
    }
  },
  cookies: {
    'sweet-cookie': {
      httpOnly: true,
      path: '/',
      value: 'choco'
    }
  },
  error: false,
  headers: {
    connection: 'close',
    'content-length': '130',
    'content-type': 'application/json; charset=utf-8',
    date: expect.any(String),
    etag: expect.any(String),
    'set-cookie': 'sweet-cookie=choco; Path=/; HttpOnly',
    'x-powered-by': 'Express'
  },
  location: undefined,
  ok: true,
  redirect: false,
  status: 200,
  statusCode: 200,
  statusText: 'OK',
  text: expect.any(String) // Stringified body
});
```

#### Fastify Endpoint Testing

Example usage of **auth** method to set the Authorization header based on the provided token.
Also, in response, you're able to validate cookies sent by the server.

```ts
import { request } from '../src/index.js';

// Don't forget to wait until all plugins are registered.
await fastifyApp.ready();

// Don't forget to use .server instead of plain fastify instance.
const response = await request(fastifyApp.server).get('/').auth('jwtToken');

expect(response).toEqual({
  body: {
    message: 'I love my mom!',
    requestHeaders: {
      authorization: 'Bearer jwtToken',
      connection: 'close',
      host: expect.any(String)
    }
  },
  cookies: {
    'sweet-cookie': {
      httpOnly: true,
      path: '/',
      value: 'choco'
    }
  },
  error: false,
  headers: {
    connection: 'close',
    'content-length': '127',
    'content-type': 'application/json; charset=utf-8',
    date: expect.any(String),
    'set-cookie': 'sweet-cookie=choco; HttpOnly'
  },
  location: undefined,
  ok: true,
  redirect: false,
  status: 200,
  statusCode: 200,
  statusText: 'OK',
  text: expect.any(String) // Stringified body
});
```

## 📚 API Documentation

The API documentation is available [here](https://eddienubes.github.io/sagetest/).
If you need more examples or have some questions, just open an issue or submit a pull request.
I'll be happy to help you out.

## ❤️ Contributing

If you wish to contribute to the evolution of this package,
please feel free to submit your issues or open pull requests.
You are always welcome.
🥰

## License

MIT (c) Eddie Nubes

sagetest

sagetest Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

sagetest

sagetest Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README