In this news series called #shorts I'm taking a dig at few small but peculiar problems and their solution.
We all know that cypress.io is a really cool automation tool where one can easily automate API and UI part of an web application easily. Cypress has everything working out for its success, as it provides most of the thing out of the box; except for few things which one has to tackle in not so easy fashion.
In this #short we are gonna explore how to tackle a simple JSON File Upload using cypress custom commands.
The problem that we're solving is to upload a JSON file passed as a form-data to an API end-point with a multipart/form-data request.
We are gonna start with writing a custom cypress command called "uploadFile()" inside /cypress/support/command.js
uploadFile() takes in 2 arguments;
url = the endpoint to where we have to upload a file,
formData = form-data object we have to pass along to the endpoint
We can reuse this command any number of times we'd like without repeating this code again and again.
Writing the code:
In the following code, we are fetching the user data from user.json present inside fixtures.
Once we have the user data we convert it to a blob using Cypress.blob base64StringToBlob() method (which converts a base64 string to a blob). We then use this created blob to construct a file by creating a new File object using a new File().
After that just create a simple form-data object and pass this newly formed File object into "content" form-data param.
The last thing is just to call cy.uploadFile() and pass the requestURL and form-data. The response to this request is stored in the "@createANewUser" alias.
btoa(JSON.stringify(data)) is reuired to convert the binary user.json data string to base64 encoding first. Check this link for more information about base64 encode/decode
In the above article, we did the uploading of JSON file using now deprecated cy.server() and cy.route() commands; though they will keep working as a plugin in Cypress in the future until we will keep seeing a deprecation message in cypress console.
So there is an alternate implementation of cy.uploadFile() command
Now it can happen that sometimes the response that we get from this comment is not in plain JSON i.e it may contain Buffer object.
So we can Sanitize this using the below code:
That's all folks!!