Skip to content
Computest Openrunner: Benchmark and functional testing for frontend-heavy web applications
JavaScript HTML Other
Branch: master
Clone or download
Latest commit 6069b29 Nov 12, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Basic templates for github Oct 27, 2017
bin
building Rework build scripts, bootstrapping of the extension and launching fi… Nov 12, 2019
core/lib Move the script-env Worker to its own special tab in the script window Nov 12, 2019
examples
icons A new utility to generate macOS application bundles Dec 10, 2017
lib Rework build scripts, bootstrapping of the extension and launching fi… Nov 12, 2019
runner-modules Move the script-env Worker to its own special tab in the script window Nov 12, 2019
test
.editorconfig Core project structure Oct 27, 2017
.eslintrc.json
.gitignore
.istanbul.yml Core project structure Oct 27, 2017
.travis.yml Split up the test jenkins job into unit tests and integration tests Apr 8, 2019
LICENSE Basic templates for github Oct 27, 2017
README.md Merge all bin commands into a single command with subcommands Jul 2, 2018
index.js Rework build scripts, bootstrapping of the extension and launching fi… Nov 12, 2019
manifest.json 4.0.0 Nov 12, 2019
package.json 4.0.0 Nov 12, 2019

README.md

Computest Openrunner

Build Status Coverage Status Greenkeeper badge

Openrunner can be used for benchmark and functional testing for frontend-heavy web applications. It's a tool that simulates an end user using a website. It simulates user behaviour (keyboard/mouse activity) to browse through an online application. This can be used to test functionality and/or response times. Openrunner is a browser extension but can also be run from the command line i.e. for integration in a build pipeline.

Getting started:

First of all, because this project is not an official browser extension yet, you will have to download and install Firefox Nightly: https://nightly.mozilla.org/ (You can also use Firefox "Unbranded" or "Developer Edition", but not the regular firefox).

Then you must make sure that you have node.js installed (version 8 or higher): https://nodejs.org/en/download/.

You can open the Openrunner IDE using your terminal:

npx openrunner ide --firefox '/Applications/Firefox Nightly.app/Contents/MacOS/firefox'

(Update the path to firefox as needed)

After executing this command, Firefox will launch and you can click on the Openrunner Icon to start the Openrunner IDE.

Openrunner will launch with a small example script to get you started. The buttons on top of the screen can be used to open or save a script, execute or stop it. The two numbers are for the interval and the amount of runs you'd like to do (by default it's set to 1 run every 60 seconds), the last field is the current status.

After executing a script you'll be presented with the outcome. The top half of the screen shows the measured response times per step, and errors when/if they occur.

The bottom half of the screen shows the result of the run in json-format. Also, there's a 'view breakdown' button, this will open a complete breakdown of every step/event/object loaded that happened during the script execution.

Much more documentation on how to create scripts is available on the wiki on github: https://github.com/computestdev/Openrunner/wiki/Scripting-guide-(with-examples)

Running scripts using your terminal

You can run saved scripts using your terminal:

npx openrunner run --firefox '/Applications/Firefox Nightly.app/Contents/MacOS/firefox' --script myScript.js --result myResult.json --headless

After this command has completed, you can inspect/parse all the results in the myResult.json file.

You can’t perform that action at this time.