Picks an arbitrary permutation. :package: :smiley_cat: :running: :vhs: :moon: :scroll: :newspaper: :blue_book:

Alternatives: permutation, permutation$. Similar: permutation, permutations, hasPermutation.

This is part of package extra-array.

This is browserified, minified version of @extra-array/permutation. It is exported as global variable array_permutation. CDN: unpkg, jsDelivr.

array.permutation(x, [n], [r]);
// x: an array
// n: number of values (-1 => any)
// r: random seed 0->1

const array = require("extra-array");

var x = [1, 2, 3, 4, 5];
array.permutation(x, 5);
// [ 2, 4, 5, 1, 3 ]

array.permutation(x, 5, 0.3);
// [ 5, 3, 1, 2, 4 ]

array.permutation(x, 3, 0.3);
// [ 5, 3, 1 ]

References

• shuffle: PHP
• Array.shuffle: sugarjs
• shuffle-seed: @webcaetano
• shuffle-array: @pazguille
• Seeding the random number generator in Javascript