Skip to content

Exploratory test monkey that becomes smarter over time

License

Notifications You must be signed in to change notification settings

lenntt/kinglouie

Repository files navigation

Build Status codecov BCH compliance

Description

Your exploratory test monkey that becomes smarter over time.

King Louie:

Oh, oobee doo
I wanna be like you
I wanna walk like you
Talk like you, too
You'll see it's true
An ape like me
Can learn to be human too

Prerequisites

  • nodejs >= 8 (depending on async and using es6), with npm
  • Chrome

To run

clone this repo and

npm install
npm test
node samples/google/main.js

screenshot

Definitions

The Labelled Transition System

  • A Model (Labeled Transition System), consists of:
    • Labels
      • A label is either a stimulus (e.g. click), a response (e.g. an error), or quiesence (δ, absence of any output).
      • Can define parameters
    • States
      • Which have outgoing Transitions
        • Which have a from state, a label, and a to state.
        • May have a guard which specifies conditions on label parameters
      • One state is the initialState
  • An InstantiatedLabel is a label, but with actual data and meta data.
  • A Trace is a list of observed InstantiatedLabels.

The Adapter

You must implement an Adapter, which is an object that has async functions preamble, waitForOutput and determineState. See samples (samples/google/main.js). The adapter folder contains predefined methods to interact with a page.

KingLouie

Is using your Adapter and builds up an observation Model.

Known limitations

  • Kinglouie does not interact with iframes or new windows (popups).
  • Kinglouie does not handle modal dialogs (e.g. alert());