A caching HTTP proxy for integration tests. NOT SUITABLE FOR PRODUCTION USE!
npm install @loopback/http-caching-proxyA caching HTTP proxy for integration tests.
NOT SUITABLE FOR PRODUCTION USE!
Testing applications connecting to backend REST/SOAP services can be difficult:
The backend service may be slow, apply rate limiting, etc. Integration tests
become too slow in such case, which makes test-first development impractical.
This can be addressed by setting up a snapshot-based mock server or using a
caching HTTP client, but both of these solutions come with severe disadvantages:
- When using a snapshot-based mock server, we must ensure that snapshots are
up-to-date with the actual backend implementation.
- Caching at HTTP-client side requires non-trivial changes of the application
code.
A filesystem-backed caching HTTP proxy offers a neat solution that combines
caching and snapshots:
- The first request is forwarded to the actual backend and the response is
stored as a snapshot.
- Subsequent requests are served by the proxy using the cached snapshot.
- Snapshot older than a configured time are discarded and the first next request
will fetch the real response from the backend.
``sh`
npm install --save-dev @loopback/http-caching-proxy
Import the module at the top of your test file.
`ts`
import {HttpCachingProxy} from '@loopback/http-caching-proxy';
Create a proxy instance during test-suite setup (typically in Mocha's before
hook):
`ts`
const proxy = new HttpCachingProxy({
// directory where to store recorded snapshots - required
cachePath: path.resolve(__dirname, '.proxy-cache'),
// port where to listen - 0 by default
port: 0,
// how often to re-validate snapshots (in milliseconds) - one day by default
ttl: 24 60 60 * 1000,
});
await proxy.start();
In your tests, configure the client library to use the caching proxy. Below is
an example configuration for axios:
`ts`
const parsed = new URL(proxy.url);
const proxyConfig = {
host: parsed.hostname,
port: parseInt(parsed.port),
protocol: parsed.protocol,
auth: {
username: parsed.username,
password: parsed.password,
},
};
const request = axios.create({
// Axios does not support proxy url directly
proxy: proxyConfig,
});
Finally, stop the proxy when the test suite is done (typically in Mocha's
after hook):
`ts`
await proxy.stop();
See the auto-generated documentation at
loopback.io
A caching proxy is great if you want your tests to talk to the real backend
service. There are many cases where such behavior is not desirable and the tests
must run fully isolated. If that's your situation, then please consider using a
tool that can record and replay HTTP interactions, for example:
Just make sure you have a process in place to verify that your recorded
interactions are staying up to date with the actual behavior of the backend
service!
Run npm test` from the root folder.
See
all contributors.
MIT