Neat and streamlined testing library for node.js HTTP servers powered by undici.
Documentation | Getting Started
- Yes! This is a reference to my favourite Valorant character, Sage.
- TypeScript friendly, exposes both ESM and CJS modules.
- Built on top of 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 v16.5 and above.
- No unnecessary third-party dependencies.
- Automatically handles cookie parsing.
npm install -D sagetest
yarn add -D sagetest
pnpm add -D sagetestSagetest supports Node.js v16.5 and above out of the box. Even though undici's support starts from Node.js v18. This is possible due to one-liner polyfills for WebAPI Readable/WritableStreams and Blob, which were not available at that time globally (globalThis).
There are several other methods which you can find in the API documentation. In general, the usage experience should resemble that of supertest.
Example usage of auth method to set Basic Auth header based on username and password.
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
});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.
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
});The API documentation is available here. 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.
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. 🥰
MIT (c) Eddie Nubes