Usage
Installation
It can be installed with either npm or yarn
$ npm install graphql --save
$ npm install easygraphql-tester --save-dev
$ yarn add graphql
$ yarn add easygraphql-tester --dev
How to use it?
easygraphql-tester
can be used to make different types of tests. Those
different types are going to be:
- To test the resolvers.
- To test the queries, mutations and subscriptions with mocked data.
- As an assertion package
Testing GraphQL resolvers
To execute a query against your GraphQL resolvers, you should use the method
grapqhl
from the class initializated.
it'll receive 4 arguments, the only one that is required is the first argument, those arguments are:
query
: The query/mutation you want to test.rootValue
: It's going to be the rootValue to pass to the resolver.contextValue
: It's going to be the context to pass to the resolver.variableValues
: It's going to be the variables that the query/mutation are going to use.
const gql = require('graphql-tag')
const EasyGraphQLTester = require('easygraphql-tester')
const tester = new EasyGraphQLTester(schema)
const query = gql`
{
user(id: 5) {
firstName
lastName
}
}
`
const result = await tester.graphql(query)
Using GraphQL.js
schema.js
'use strict'
const { GraphQLSchema, GraphQLObjectType, GraphQLString } = require('graphql')
const schema = new GraphQLSchema({
query: new GraphQLObjectType({
name: 'RootQueryType',
fields: {
hello: {
type: GraphQLString,
resolve() {
return 'Hello World!';
}
}
}
})
});
module.exports = schema
test/resolvers.js
"use strict";
const gql = require('graphql-tag')
const { expect } = require("chai");
const EasyGraphQLTester = require("easygraphql-tester");
const schema = require("../schema");
const tester = new EasyGraphQLTester(schema);
describe("Test resolvers", () => {
it("should return expected values", async () => {
const query = gql`
{
hello
}
`;
const result = await tester.graphql(query);
expect(result.data.hello).to.be.eq("Hello World!");
});
});
Without graphql-js
If you are not using graphql-js, you might pass the resolvers as second argument to the constructor in order to test the resolvers.
schema.js
'use strict'
const schema = `
type Query {
hello: String!
}
`
function hello(root, args, ctx) {
return 'Hello World!'
}
const resolvers = {
Query: {
hello
}
}
module.exports = { schema, resolvers }
test/resolvers.js
"use strict";
const gql = require('graphql-tag')
const { expect } = require("chai");
const EasyGraphQLTester = require("easygraphql-tester");
const { schema, resolvers } = require("../schema");
const tester = new EasyGraphQLTester(schema);
describe("Test resolvers", () => {
it("should return expected values", async () => {
const query = gql`
{
hello
}
`;
const result = await tester.graphql(query);
expect(result.data.hello).to.be.eq("Hello World!");
});
});
Resolvers
To test GraphQL resolvers, there is something extra to do in case you are not using graphql-js.
This is going to be async
.
'use strict'
const EasyGraphQLTester = require('easygraphql-tester')
const fs = require('fs')
const path = require('path')
const resolvers = require('./resolvers')
const userSchema = fs.readFileSync(path.join(__dirname, 'schema', 'user.gql'), 'utf8')
const tester = new EasyGraphQLTester(userSchema, resolvers)
Testing the resolvers
After you initializate the class, you can use the method graphql
and
const tester = new EasyGraphQLTester(schema, resolvers)
tester.graphql(query, undefined, undefined, { isLocal: false })
.then(result => console.log(result))
.catch(err => console.log(err))
// result
// {
// "data": {
// "getFamilyInfoByIsLocal": {
// "id": "1",
// "isLocal": false
// }
// }
}
One schema file
'use strict'
const EasyGraphQLTester = require('easygraphql-tester')
const fs = require('fs')
const path = require('path')
const userSchema = fs.readFileSync(path.join(__dirname, 'schema', 'user.gql'), 'utf8')
const tester = new EasyGraphQLTester(userSchema)
Multiples schemas files
'use strict'
const EasyGraphQLTester = require('easygraphql-tester')
const fs = require('fs')
const path = require('path')
const userSchema = fs.readFileSync(path.join(__dirname, 'schema', 'user.gql'), 'utf8')
const familySchema = fs.readFileSync(path.join(__dirname, 'schema', 'family.gql'), 'utf8')
const tester = new EasyGraphQLTester([userSchema, familySchema])
Assertion
easygraphql-tester
works as an assertion library used to make tests with your favorite test runner.
To use it as an assertion library, you must follow the next steps:
- Define a Query or Mutation to test.
-
Pass as first argument, a boolean to
.test(true)
or.test(false)
.- true: if it is fine, everything should work fine.
- false: if it should fail, there is an error or invalid field on the query/mutation or arguments/input.
- Pass as second argument, the query/mutation to test.
- The third argument is required if it is a mutation, it must be an object with the fields of the input
The next example is going to be made with mocha, but it can be done with your favorite test runner.
Mocha example
'use strict'
const fs = require('fs')
const path = require('path')
const EasyGraphQLTester = require('../lib')
const userSchema = fs.readFileSync(path.join(__dirname, 'schema', 'user.gql'), 'utf8')
const familySchema = fs.readFileSync(path.join(__dirname, 'schema', 'family.gql'), 'utf8')
describe('Test my queries, mutations and subscriptions', () => {
let tester
before(() => {
tester = new EasyGraphQLTester([userSchema, familySchema])
})
describe('Should pass if the query is invalid', () => {
it('Invalid query getUser', () => {
const invalidQuery = `
{
getUser {
id
invalidField
familyInfo {
father {
email
username
}
}
}
}
`
// First arg: false, there is no invalidField on the schema.
tester.test(false, invalidQuery)
})
it('Should pass if the query is valid', () => {
const validQuery = `
{
getMeByTestResult(result: 4.9) {
email
}
}
`
tester.test(true, validQuery)
})
it('Should pass if the mutation is valid', () => {
const mutation = `
mutation UpdateUserScores($scores: ScoresInput!) {
updateUserScores(scores: $scores) {
email
scores
}
}
`
tester.test(true, mutation, {
scores: {
scores: [1, 2, 3]
}
})
})
it('Should not pass if one value on the mutation input is invalid', () => {
const mutation = `
mutation UpdateUserScores($scores: ScoresInput!) {
updateUserScores(scores: $scores) {
email
scores
}
}
`
// First arg: false, there is no invalidField on the schema.
tester.test(false, mutation, {
scores: {
scores: [1],
invalidField: true
}
})
})
it('Should search', () => {
const query = `
{
search(id: "1") {
... on User {
id
}
... on FamilyInfo {
id
father {
username
}
brothers {
username
}
}
}
}
`
tester.test(true, query)
})
it('Should test a subscription', () => {
const subscription = `
subscription {
newUsers(limit: 1) {
id
username
email
}
}
`
tester.test(true, subscription)
})
})
})
Mocking Queries and Mutations
easygraphql-tester
can works as a mocker of your query or mutation, using it is simple.
Call the method .mock()
and pass an object with this options:
- query: It'll be the query/mutation to test.
- variables: This is required if it is a mutation, it must be an object with the fields of the input.
- fixture: This is optional, it'll be an object with the key
data
and inside it the name of the query/mutation/subscription and the fields to set. - saveFixture: By default is
false
, if you pass fixtures, and set it totrue
when you make the same query again, it will return the fixture value. - validateDeprecated: If you want to validate if the query is requesting a deprecated field, set this option to
true
and it'll return an error if a field is deprecated. - mockErrors: If you want to mock the errors instead of throwing it, set this option to
true
and now, the responsw will have{ data: ..., errors: [...] }
The result will have top level fields, it means that the result will be an object
with a property that is going to be data
and inside it the name (top level field)
of the query or alias with the mocked result.
In case you have a custom scalar, set the value on the fixture, if it's not set it will be {}
Fixtures:
There are two ways to set the fixture on a operation:
Operation options:
Set the fixture as an option when testing a query/mutation/subscription
E.g
const fixture = {
data: {
getUser: {
id: '1',
name: 'EasyGraphQL'
}
}
}
const { data: { getUser } } = tester.mock({ query, fixture })
setFixture()
method
Also, the fixture can be set before the test using .setFixture()
method from the constructor,
it'll receive two arguments; the first one is going to be the fixture, and the second one will be
an object of options to set if it should auto mock the extra fields that are on the query but are not
on the fixture, by default it's true
.
Run tester.clearFixture()
to return the fixture to null
and autoMock = true
in case you
set it to false
E.g
const tester = new EasyGraphQLTester([userSchema, familySchema])
const fixture = {
data: {
getUser: {
id: '1',
name: 'EasyGraphQL'
}
}
}
tester.setFixture(fixture, { autoMock: false })
const { data: { getUser } } = tester.mock({ query })
tester.clearFixture()
Mock example
'use strict'
const EasyGraphQLTester = require('easygraphql-tester')
const fs = require('fs')
const path = require('path')
const userSchema = fs.readFileSync(path.join(__dirname, 'schema', 'user.gql'), 'utf8')
const familySchema = fs.readFileSync(path.join(__dirname, 'schema', 'family.gql'), 'utf8')
const tester = new EasyGraphQLTester([userSchema, familySchema])
const query = `
{
getUser(id: "1") {
id
name
familyInfo {
lastName
email
}
}
}
`
const fixture = {
data: {
getUser: {
id: '1',
name: 'EasyGraphQL'
}
}
}
const { data: { getUser } } = tester.mock({ query, fixture, validateDeprecated: true })
const { errors } = tester.mock({
query,
fixture: {
errors: [
{
"message": "Cannot query field \"invalidField\" on type \"FamilyInfo\".",
"locations": [
{
"line": 7,
"column": 5
}
]
}
]
}
})
const queryWithAlias = `
{
firstUser: getUser(id: "1") {
id
}
}
`
const { data: { firstUser } } = tester.mock({ query: queryWithAlias })
const mutation = `
mutation CreateUser($input: CreateUserInput!) {
createUser(input: $input) {
id
name
}
}
`
const input = {
input: {
name: 'test'
}
}
const { data: { createUser } } = tester.mock({ query: mutation, variables: input })
Mock result
// getUser
{
id: '1',
name: 'EasyGraphQL',
familyInfo: [
{
lastName: 'Bartoletti',
email: 'YSjsYuV@wtnK.com'
},
{
lastName: 'Bartoletti',
email: 'YSjsYuV@wtnK.com'
},
{
lastName: 'Bartoletti',
email: 'YSjsYuV@wtnK.com'
}
]
}
// errors
{
[
{
"message": "Cannot query field \"invalidField\" on type \"FamilyInfo\".",
"locations": [
{
"line": 7,
"column": 5
}
]
}
]
}
//firstUser
{
id: '93'
}
// createUser
{
id: '93',
name: 'Tony Patrick'
}