UNPKG

@sugarcube/test

Version:

Test helpers and strategies for SugarCube.

98 lines (54 loc) 3.33 kB
# `@sugarcube/test` Test helpers for SugarCube. ## Installation ``` npm install --save @sugarcube/test ``` ## API ### generators.listArb An arbitrary that can be used in `jsverify` based property tests. It produces a single object that resembles a list. ### generators.listsArb An arbitrary that can be used in `jsverify` based property tests. It produces an array of objects, where each object is a list. ### generators.lists Randonly generate a list of lists. **Parameters** - `size` **[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)** The number of lists to generate. Returns **[Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)>** A list of list objects. ### generators.queryArb An arbitrary that can be used in `jsverify` based property tests. It produces a single object that resembles a query. ### generators.queriesArb An arbitrary that can be used in `jsverify` based property tests. It produces an array of objects, where each object is a list. ### generators.queries Randonly generate a list of queries. **Parameters** - `size` **[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)** The number of queries to generate. Returns **[Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)>** A list of queries. ### generators.unitArb An arbitrary that can be used in `jsverify` based property tests. It produces a single object that resembles a unit of data. ### generators.unit Randomly generate a single unit of data. Returns **[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)** A unit of data. ### generators.dataArb An arbitrary that can be used in `jsverify` based property tests. It produces an array of objects, where each object is a unit of data. ### generators.data Randonly generate units of data.. **Parameters** - `size` **[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)** The number of data units to generate. Returns **[Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)>** A list of data units. ### generators.envelopeArb An arbitrary that can be used in `jsverify` based property tests. It produces an object that is an envelope.. ### generators.envelope Randomly generate a envelope with data and queries. **Parameters** - `sizeData` **[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)** The number of data units in the envelope. - `sizeQueries` **[number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number)** The number of queries in the envelope. Returns **[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)** A unit of data. ## License [GPL3](./LICENSE) @ [Christo](christo@cryptodrunks.net)