Skip to content

Latest commit

 

History

History
74 lines (49 loc) · 2.78 KB

README.md

File metadata and controls

74 lines (49 loc) · 2.78 KB

Reflekt JS

MPLv2 License

Reflection-driven development.

Test-driven development is fine but it's not perfect. Tests often check for a golden path that works, when errors actually happen when the code or user does something unexpected. And with automated testing humans still have to write the tests.

Reflekt writes the tests for you, and tests in the negative for situations that you wouldn't have noticed. It works out of the box with no extra coding required. Because Reflekt tests your objects as they are used in the normal flow of the application, you get real world test results.

Installation

Run:

npm install reflekt-js

Enable per environment:

Reflekt.enabled = true;

Usage

Inside an object that you want to test add:

Reflekt(this);

Use the application as usual and test results will start showing up in the reflections folder.

Configuration

You can configure Reflekt to skip "no undo" functions like deletion and sending email:

In your object add:

Reflekt.skip('function_name')

Also consider disabling Reflekt on functions that do the final rendering to the UI, to avoid a visual mess of duplicated elements.

How it works

When a function is called in the usual flow of an application, Reflekt runs multiple simulations with different values on that function to see if it can break things, before handing back control to the function to perform its usual task.

Comparison

Conceptual differences between TDD and RDD:

Test-driven development Reflection-driven development
Automation Tests are defined manually. Tests are defined automatically.
Granularity Tests either PASS or FAIL. Tests are averaged into a PASS RATE.
Replication Tests run externally on a new structure. Tests run internally on the real world structure.
Feedback loop Tests run periodically. Tests run in real time.

Consider this logic:

  1. Tests often check that things work (in the positive)
  2. Errors happen when things break (in the negative)
  3. Tests should check more often for the negative
  4. This can be automated

QA

Q. Can I use it alongside test driven development too?
A. Yes!