shuffle-arr

Randomize the order of the elements in array or array-like object.

Heavily inspirated by Fisher–Yates shuffle.

Install

$ npm install --save shuffle-arr

Usage

For more use-cases see the tests

var shuffle = require('shuffle-arr');

shuffle([1, 2, 3, 4, 5]);
// => [2, 5, 1, 4, 3]

// return a shuffled copy of the given array.
shuffle([1, 2, 3, 4, 5], { copy: true });

shuffle('abcdef');
// => dceafb

Related

• is-index - Checks if the given value is a valid array-like index.
• is-length - Checks if the given value is a valid array-like length.
• to-length - Converts value to an integer suitable for use as the length of an array-like object.
• pick-item - Randomly sampling a item from an array.
• pick-items - Randomly sampling some items from an array.
• drop-left - Creates a slice of array with n elements dropped from the beginning.
• drop-right - Creates a slice of array with n elements dropped from the end.
• is-array-like - Checks if the given value is an array or array-like object.

Contributing

Pull requests and stars are highly welcome.

For bugs and feature requests, please create an issue.