What is gatlingjs?
An npm library to run gatling from node.js project by placing the simulation files in your project repository.
Does it have any pre-requisities?
- In order to run Gatling, you need to have a JDK installed. Gatling requires JDK8, still recommend that you use an up-to-date version.
- Make sure that JAVA_HOME is set properly
How should i install this library?
This is meant to be installed as a dev dependency in your project folder
npm i gatlingjs -D
How do I configure my project to add simulation files
At present, gatlingjs needs the following folders in your project root
- test/performance/results => html representation of results
- test/performance/user-files/simulations => .scala files used for simulation
- test/performance/user-files/data => data feed
- test/performance/user-files/bodies => request body related stuff
How do i run it?
./node_modules/gatlingjs/dist/index.js
Behind the scenes, gatlingjs will scan test/performance/user-files/simulations for the simulation files and prompt you to choose the simulation you wanna run.
Is there a sample project?
You can find it at https://github.com/abhiche/gatlingjs-example
By the way, is there any documentation for gatling?
- http://gatling.io/docs/current/quickstart/
- http://gatling.io/docs/current/advanced_tutorial/#advanced-tutorial
Note:
- You do not need to explicitly download the binaries from gatling.io since gatling is embedded in this library.
- At the moment, this works only on nix platform. Please feel free to contribute to support it on windows too.
TODOs
- Unit tests
- Support command line arguments available in gatling
- Compatibility with Windows Platform