mocha-froth/README.md

1.9 KiB
Raw Blame History

mocha-froth

v0.2.1

Keith Irwin

Build Status Coverage Status

Fuzzer for mocha testing. Or any javascript testing suite, really. This package provides a function that returns an array of random strings. You know, a fuzzer.

Installation

npm install mocha-froth

Usage

Import froth into your project

const froth = require('mocha-froth')

Use the syntax froth(num, max, opt)where:

  • num is the number of strings generated
  • max is the maximum string length
  • opt is an object of options for characters to include
opt = {
	// Set to true to include tests with...
	none: true, // Empty string
	whitespace: true, // Various whitespace chars
	quotes: true, // Combinations of quotes
	backslashing: true, // Combinations of backslashes
	symbols: true, // Various symbols
	foreign: true, // Foreign chars
	alphanumeric: true, // Ordinary letters and numbers
}

Examples

Create ten random strings, each up to twenty characters (default):

console.log( froth() )
// [ '``8\\ёðNàЧ,', 'µ', '\\,нcy', '?O¬ìè¶ſ\r4á%"Е~', '', 'ИôAàяjùgzH%хйf', 'd\r\nïЧо', '«&pcj→ъгPfЬа|h', 'ñgMſииe&?“3ьXî¢òдq<ц', 'Un5tĸ' ]

Create five strings up to ten characters:

console.log( froth(5,10) )
// [ '¢m\'\'\'ý7\'', 'óé€с-', 'фяþnЭOо', '', 'ykUбáФ¿ŷ¢С' ]

Same as above, but without foreign characters:

console.log( froth(5,10,{foreign:false}) )
// [ 'VP"""t¬mK²', '²L6)>\r\nV', 'v,→“', '*e8', '→' ]

Testing

npm test