Nock es una biblioteca de simulación de servidor HTTP y expectativas para Node.js que intercepta llamadas de red salientes mediante http.request.
Simulación básica (Mocking)
const nock = require('nock');
// Simular un endpoint GET
const scope = nock('https://api.example.com')
.get('/users/1')
.reply(200, {
id: 1,
name: 'Alice Cooper'
});
// Permitir que las solicitudes no simuladas pasen a la red real
const unmockedScope = nock('https://api.example.com', {
allowUnmocked: true
});
Filtrado de peticiones y coincidencia de Query
Coincidencia de parámetros Query
nock('https://api.example.com')
.get('/search')
.query({ q: 'cheese', page: '1' })
.reply(200, { results: [] });
Filtrado de rutas (enmascarar tokens dinámicos)
Elimina tokens dinámicos o marcas de tiempo antes de comparar:
nock('https://api.example.com')
.filteringPath(/[&?]token=[^&]*/g, '')
.get('/user')
.reply(200, { authorized: true });
// Intercepta "/user?token=xyz123" como "/user"
Simular peticiones POST y cabeceras
nock('https://api.example.com')
.matchHeader('authorization', 'Bearer token_123')
.post('/checkout', { items: [1, 2] })
.reply(201, { status: 'created' }, {
'X-Custom-Header': 'MockValue'
});
Aserciones y limpieza
// Verificar que todos los interceptores declarados fueron invocados
scope.isDone(); // => true / false
// Limpiar todos los interceptores activos
nock.cleanAll();
// Restaurar el comportamiento HTTP original de Node.js
nock.restore();