Randomize the order of items in an array
npm install array-shuffle> Randomize the order of items in an array
Uses the Durstenfeld algorithm which is based on the Fisher–Yates algorithm.
``sh`
npm install array-shuffle
`js
import {arrayToShuffled, arrayShuffle} from 'array-shuffle';
// Create a new shuffled array
const shuffled = arrayToShuffled([1, 2, 3, 4, 5, 6]);
//=> [3, 5, 4, 1, 2, 6]
// Shuffle in-place
const array = [1, 2, 3, 4, 5, 6];
arrayShuffle(array);
console.log(array);
//=> [3, 5, 4, 1, 2, 6]
`
Create a new array with the items randomized (does not mutate the original array).
Returns a new array with the items randomized.
#### array
Type: Array
The array to shuffle.
#### options
Type: object
##### randomNumberGenerator
Type: () => number
Custom random number generator that returns a float between 0 (inclusive) and 1 (exclusive). This is useful for deterministic shuffling when you use a seeded generator.
`js
import {arrayToShuffled} from 'array-shuffle';
const randomNumberGenerator = () => 0;
const deterministic = arrayToShuffled([1, 2, 3, 4, 5, 6], {randomNumberGenerator});
//=> [2, 3, 4, 5, 6, 1]
`
Randomize the order of items in an array, mutating the array in-place.
Returns the input array shuffled.
#### array
Type: Array
The array to shuffle.
#### options
Type: object
##### randomNumberGenerator
Type: () => number`
Custom random number generator that returns a float between 0 (inclusive) and 1 (exclusive). This is useful for deterministic shuffling when you use a seeded generator.