nock-graphql
v2.1.0
Published
Nock-based GraphQL testing library
Downloads
2,198
Maintainers
Readme
nock-graphql
A nock-based GraphQL testing library that provides a functionality to mock queries and mutations.
In contrast to Apollo's MockedProvider, nock allows a realistic testing with the actual http
calls being made from your client code.
Installing
You'll need nock
, cross-fetch
as peer dependencies in order to use this library.
npm install -D nock-graphql nock cross-fetch
Additionally, you need to set up global fetch
implementation incorporated in your jest
environment:
global.fetch = require('cross-fetch')
or, directly in your ApolloClient
const client = new ApolloClient({
link: new HttpLink({ fetch, uri: ENDPOINT }),
});
Usage
I. Create nock-graphql
instance
A. You could create it globally:
// Create the instance in a separate file and export it.
import { NockGraphQL } from 'nock-graphql';
export const nockgql = new NockGraphQL('http://localhost:4000/graphql');
B. Create directly in the test files:
import { NockGraphQL } from 'nock-graphql';
let nockgql: NockGraphQL;
beforeAll(() => {
nockgql = new NockGraphQL('http://localhost:4000/graphql');
});
II. Mocking queries
import { gql } from 'graphql-tag';
import { ApolloClient, HttpLink, InMemoryCache } from '@apollo/client';
import { MockConfig } from 'nock-graphql';
type QueryVariables = {
id: string;
};
type QueryResult = {
foo: { bar: string };
};
const GetQuery = gql`
query Test($id: String) {
foo(id: $id) {
bar
}
}
`;
beforeEach(() => {
client = new ApolloClient({
link: new HttpLink({ uri: 'http://localhost:4000/graphql' }),
cache: new InMemoryCache({ addTypename: false }),
});
});
afterEach(() => {
nockgql.cleanup();
});
test('should match the query', async () => {
const config: MockConfig<QueryVariables, QueryResult> = {
document: GetQuery,
variables: { id: '1' },
data: {
foo: {
bar: 'Hello, World',
},
},
};
const scope = nockgql.mock(config);
await client.query({ query: GetQuery, variables: { id: '1' } });
scope.done();
});