Skip to content

Katarzyna Kmiotek

Testing GraphQL with Playwright

API testing, Playwright, GraphQL2 min read

logo I believe you have heard about Playwright and its a great support for browser automation tests. A week ago Playwright released support for API testing and I hope you are excited about it as I am.
REST API of course! Can I use Playwright for testing GraphQL endpoint? YES !
Keep reading to find out how easy it is.

Set up

Now you can start a new Playwright project with just one command:

1npm init playwright api-tests

When prompt for input I answer yes to JavaScript and e2e folder. I also install Faker

1npm install faker

In the e2e folder, you can find example.spec.js - I won't be using it so please bin it and create file api.spec.js. In playwright.config.js please remove the projects array (one that lists browsers and devices) - we won't need it. In the use section please add baseURL :
baseURL
(I am using my GraphQL endpoint https://graphql-teas-endpoint.netlify.app/ with methods to get all teas, get one tea, add a new tea or delete a tea)
In playwright.config.js you can also pass httpHeaders ( Content type , authorization etc) and httpCredentials .
To execute tests run

1npx playwright test

to run with reporter

1npx playwright test --reporter=html

Start

We will be using Playwright test runner so import it on the top of the file along with faker.
imports
On the top, I also define a few variables and queries:
variables
If you have used Playwright test runner before you will be familiar how the scope of the test looks like, the difference is that instead of using page object we will be using request

test

A little bit about the above test:

  • it is the GraphQL endpoint so all calls to it are POST methods (because we post query body or mutation body)
  • we post requests to "/" as all calls to GraphQL endpoint are made to the same URL
  • and finally, we post data, which in this case is a query and pass GraphQL query string to get all tea objects from the endpoint

There are a few methods available on response object:

  • status() to get response status value
  • ok() response ok (200, 201)
  • body() to get body of response
  • json() to return response as JSON object
  • text()
  • statusText()
  • url()
  • headers() , headersArray()

To understand what they represent best lets log it in the console:
console logs console output

Tests

Going back to GraphQL tests as with other API testing tools with Playwright the most difficult part is to figure out query string. Please refer to your GraphQL endpoint Playground to build the right one.
playground
Get one tea:
get one tea
Add a new tea call:
add a new tea
find a new tea
And grab a new tea id assign it to a variable and use it to delete the object later.
delete a tea

Once you have JSON response back there is no limit with assertions: check the length, check data type, assert that contains particular string etc.

Links

I highly encourage you to use this endpoint for testing and exploring what other methods are available there ( get all tea producers or add a new one ). The source code for my tests is available here
Playwright documentation regarding API testing: https://playwright.dev/docs/test-api-testing
You can also join their Slack channel and ask questions if you are blocked with anything.

There are other posts on my blog about GraphQL Testing tools, browse them here

© 2024 by Katarzyna Kmiotek. All rights reserved.
Theme by LekoArts