Fuzzy-Testing

Fuzz testing tools for node.

Because javascript is a loosely typed language, it is difficult to prepare for all the different possible types that a function might receive. In order to better build stable javascript applications, fuzzy-testing is a tool that will try many possible combinations of data types within arguments.

To install to your local project, simply run:

npm install fuzzy-testing

then, call one of the fuzzFunctions from within your testing code. If you're using jest, you can do something like this:

import { fuzzFunction } from 'fuzzy-testing';

expect(fuzzFunction(onlyBools, { maxArgs: 1 })).toEqual([]);

fuzzFunction

fuzzFunction is a function that takes a function and an object specifying it's options.

options

• returnTypes: can be an array of types represented by strings, or a function that validates.
• returnFirstError: boolean that does short circuit evaluation if true.
• maxArgs: the maximum number of arguments to send to the function.
• minArgs: the minimum number of arguments to send to the function.
• argumentTypes: an array of argument types.
• argumentValues: an array of values that will be tested.
• iterations: the number of times that a function will be run per argument combination.
• canThrowError: whether or not the function can throw an error or not.

fuzzReactComponent

Fuzzy testing also allows you to fuzz the render method of react component via fuzzReactComponent.

options

• returnTypes: can be an array of types represented by strings, or a function that validates.
• returnFirstError: boolean that does short circuit evaluation if true.
• argumentValues: an array of values that will be tested.
• iterations: the number of times that a function will be run per argument combination.
• canThrowError: whether or not the function can throw an error or not.