lodash.product/README.md

Calculates the Cartesian product between multiple collections.

# lodash.product

`_.product(...collections)`

Calculates the Cartesian product between multiple collections.

| argument | description |
| ---: | :--- |
| `collections` | Collections to calculate the Cartesian product from. |

Returns a new array.

## setup

### npm

```shell
npm i lodash.product
```

### ES module

```javascript
import 'lodash.product';
import _ from 'lodash';
```

### Node

```javascript
require('lodash.product');
let _ = require('lodash');
```

### browser

```html
<script src="https://unpkg.com/lodash"></script>
<script src="https://unpkg.com/lodash.product"></script>
```

## usage

```javascript
let product = _.product([false, true], ['a', 'b', 'c'], [{}]);
// => [[false, 'a', {}], [false, 'b', {}], [false, 'c', {}], [true, 'a', {}], [true, 'b', {}], [true, 'c', {}]]
```

---

```javascript
let array = [1, 2, 3];
let product = _.product(array, array);
// => [[1, 1], [1, 2], [1, 3], [2, 1], [2, 2], [2, 3], [3, 1], [3, 2], [3, 3]]
```