test-mixer
Test helper to generate function opts object variations
## Install
This package is [pure ESM](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c). If you're not ready yet, install an older version of this program, 2.1.0 (`npm i test-mixer@2.1.0`).
```bash
npm i test-mixer
```
## Quick Take
```js
import { strict as assert } from "assert";
import { mixer } from "test-mixer";
// check all possible combinations of all boolean opts:
const defaultOpts = {
scrapeWindshield: true,
checkOil: true,
inflateTires: false,
extinguishersCount: 1, // as non-boolean will be ignored
};
// generates 2^3 = 8 combinations all possible bools
assert.deepEqual(
mixer(
{
// empty first arg object means you want all combinations
},
defaultOpts,
),
[
{
scrapeWindshield: false,
checkOil: false,
inflateTires: false,
extinguishersCount: 1,
},
{
scrapeWindshield: true,
checkOil: false,
inflateTires: false,
extinguishersCount: 1,
},
{
scrapeWindshield: false,
checkOil: true,
inflateTires: false,
extinguishersCount: 1,
},
{
scrapeWindshield: true,
checkOil: true,
inflateTires: false,
extinguishersCount: 1,
},
{
scrapeWindshield: false,
checkOil: false,
inflateTires: true,
extinguishersCount: 1,
},
{
scrapeWindshield: true,
checkOil: false,
inflateTires: true,
extinguishersCount: 1,
},
{
scrapeWindshield: false,
checkOil: true,
inflateTires: true,
extinguishersCount: 1,
},
{
scrapeWindshield: true,
checkOil: true,
inflateTires: true,
extinguishersCount: 1,
},
],
);
// let's "pin" a value, prepare two sets of options objects,
// one where scrapeWindshield === true and another with "false"
// you'll get 2 ^ (3-1) = 4 variations:
const variationsWithScrapeWindshieldOn = mixer(
{
scrapeWindshield: true,
},
defaultOpts,
);
assert.deepEqual(variationsWithScrapeWindshieldOn, [
{
scrapeWindshield: true, // <--- pinned
checkOil: false,
inflateTires: false,
extinguishersCount: 1,
},
{
scrapeWindshield: true, // <--- pinned
checkOil: true,
inflateTires: false,
extinguishersCount: 1,
},
{
scrapeWindshield: true, // <--- pinned
checkOil: false,
inflateTires: true,
extinguishersCount: 1,
},
{
scrapeWindshield: true, // <--- pinned
checkOil: true,
inflateTires: true,
extinguishersCount: 1,
},
]);
// also 4 variations, similar but with scrapeWindshield === false pinned:
const variationsWithScrapeWindshieldOff = mixer(
{
scrapeWindshield: false,
},
defaultOpts,
);
assert.equal(variationsWithScrapeWindshieldOff.length, 4);
```
## Documentation
Please [visit codsen.com](https://codsen.com/os/test-mixer/) for a full description of the API.
## Contributing
To report bugs or request features or assistance, [raise an issue](https://github.com/codsen/codsen/issues/new/choose) on GitHub.
## Licence
MIT License.
Copyright © 2010-2025 Roy Revelt and other contributors.
