Skip to content

Latest commit

 

History

History
89 lines (72 loc) · 4.06 KB

README.md

File metadata and controls

89 lines (72 loc) · 4.06 KB

Webmonkey

Robust and versatile headless monkey testing for the modern web with reproducible steps, error alerts, strategy sharing and many other good things.

Travis   npm   License MIT   code style: prettier

It's important to remember that monkey testing should be used in conjunction with smarter tests such as integration tests.

Screenshot

Getting Started

Once webmonkey has been installed globally, you can begin testing by supplying the --url parameter you'd like to test. As that's the only required field, testing begins immediately and proceeds with 50 actions.

foo@bar:~$ webmonkey --url https://news.bbc.co.uk/

For other parameters you can type webmonkey --help at any time.

Strategy

By default each action has an equal chance of being chosen at random to be run. However you can tweak this by passing the --strategy parameter which allows for a comma separated list of actions followed by how likely they are to be chosen — for example --strategy clicker=10,reloader=0 would make clicker 10 times as likely to run than any other action – aside from reloader which will never run.

Authenticating

Oftentimes you'll want to authenticate before proceeding with the testing. In cases such as these webmonkey provides a hooks file where you export two optional functions — create and destroy — you can specify the location of the hooks file with the --hooks parameter.

The hooks file must be in the *.mjs format – for instance to authenticate on a fictitious website one might implement the following.

export const create = async (page) => {
    await page.goto('https://www.example.com/');
    await page.focus('#username');
    await page.keyboard.type('webmonkey');
    await page.focus('#password');
    await page.keyboard.type('monkeynuts');
    await page.keyboard.press('Enter');
    await page.waitForNavigation({ waitUntil: 'networkidle0' });
};

Meet the Team

Currently we have the following set of monkeys that perform various actions on your supplied domain:

Webmonkey Clicker Performs clicks in random regions of the visible viewport.
Webmonkey Networker Cycles through a list of preset network conditions.
Webmonkey Scroller Scrolls the viewport to different areas of the page.
Webmonkey Sizer Randomly selects a different height and width for the viewport.
Webmonkey Toucher Similar to the clicker action but instead performs touches.
Webmonkey Typer Focuses on random input fields and types random characters.
Webmonkey Refresher Refreshes the page occasionally.