Example to execute a load test that will upload a file to the System Under Test (SUT).
Using the built-in function open(), we can read the contents of a file given a filename or URL.
Below is a simple example showing how to load the contents of a local file data.json.
If you want to open a binary file you need to pass in "b" as the second argument.
Now that you know how to load a local file, let's look at a script that creates a POST request to upload this data to an API endpoint along with a regular text field (field in the example below):
In the example above we use the http.file() API to wrap the file contents in a FileData object. When passing a JS object as the body parameter to http.post(), or any of the other HTTP request functions, where one of the property values is a FileData a multipart request will be constructed and sent.
The previous multipart request example has some limitations:
- It's not possible to assemble the parts in a specific order, because of the unordered nature of JS objects when they're converted to Golang maps, which k6 uses internally. Uploading files in a specific order is a requirement for some APIs (e.g. AWS S3).
- It's not possible to upload multiple files as part of the same form field, because JS object keys must be unique.
To address this we suggest using the FormData polyfill for k6.
Here's an example of uploading several binary files and a text file using the polyfill:
- Both binary files will be uploaded under the images form field, and the text file will appear last in the request under the text form field.
- It's required to specify the multipart boundary in the Content-Type header, so you must assemble the header manually as shown.
- Blob is not supported or implemented. For the same functionality, use a simple object with the fields data, content_type (defaulting to "application/octet-stream") and optionally filename as shown for aBinaryFile above.