0.2.3 • Published 6 years ago
jest-nock-record v0.2.3
MOVED TO nock-record
This project has been moved to nock-record
Small, Jest-aware wrapper around Nock Back, with improved ergonomics.
Workflow
If you're familiar with Jest Snapshots, the following workflow should feel familiar.
- Record actual HTTP requests on first-time test run
- Request + response are written to a file
- A
nock
will be created on subsequent test runs, based on the previous recording
Usage
import { setupRecorder } from "jest-nock-record";
import { getGithubProfile } from "./githubProfile";
const record = setupRecorder();
describe("#getGithubProfile", () => {
it("should retrieve user info", async () => {
// Start recording, specify fixture name
const { completeRecording, assertScopesFinished } = await record("github-edorivai");
// Run your function under test
const result = await getGithubProfile("edorivai");
// Complete the recording, allow for Nock to write fixtures
completeRecording();
// Optional; assert that all recorded fixtures have been called
assertScopesFinished();
// Perform your own assertions
expect(result).toMatchSnapshot();
});
});
API
setupRecorder
Sets up your recorder
// Signature:
function setupRecorder(options?: RecorderOptions): Record;
// Usage:
const record = setupRecorder({ mode: 'record' });
Recorder Options
option | default | description |
---|---|---|
fixturePath | {test-directory}/__nock-fixtures__ | The directory where fixtures will be stored |
mode | record | "wild" \| "dryrun" \| "record" \| "lockdown" See official docs for details |
record
Starts recording HTTP requests
// Signature:
function record(fixtureName: string, options: nock.NockBackOptions = {}): Promise<Recording>;
// Usage:
const recording = await record("your-fixture-name");
Recording
Returned from a call to record
property | type | description |
---|---|---|
completeRecording | () => void | Tells Nock to complete the recording and write any fixtures |
assertScopesFinished | () => void | Asserts whether all recorded scopes have finish |
scopes | Nock.Scope[] | All Nock Scopes associated with this recording |
Usage:
const { completeRecording, assertScopesFinished } = await record("your-fixture-name");
await yourFunctionThatSendsRequests();
completeRecording();
assertScopesFinished();
Running the example
Clone this repo, then run:
npm install
npm run build
npm run test-examples