Opens a file, reading all its contents into memory for use in the script.
Use SharedArray for CSV and JSON files
open() often consumes a large amount of memory because every VU keeps a separate copy of the file in memory. To reduce the memory consumption, we strongly advise the usage of SharedArray for CSV, JSON and other files intended for script parametrization.
Function available only in init context
This function can only be called from the init context (aka init code), code in the global context that is, outside of the main export default function { ... }.
By restricting it to the init context, we can easily determine what local files are needed to run the test and thus what we need to bundle up when distributing the test to multiple nodes in a clustered/distributed test.
See the example further down on this page. For a more in-depth description, see Test lifecycle.
Parameter | Type | Description |
---|---|---|
filePath | string | The path to the file, absolute or relative, that will be read into memory. The file will only be loaded once, even when running with several VUs. |
mode | string | By default, the contents of the file are read as text, but if you specify b, the file will be read as binary data instead. |
Returns
Type | Description |
---|---|
string / ArrayBuffer | The contents of the file, returned as string or ArrayBuffer (if b was specified as the mode). |