Nefariously Programmed Mecha
    Wondering what’s next for npm?Check out our public roadmap! »

    knuth-shuffle
    DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/knuth-shuffle package

    1.0.8 • Public • Published

    knuth-shuffle

    The Fisher-Yates (aka Knuth) shuffle for Browser and Node.js

    'nuf said.

    The Fisher-Yates (Knuth) Shuffle

    As Microsoft learned the hard way (see article below), function random() { return 0.5 - Math.random() } turns out to be no-so-random at all.

    The fisher-yates shuffle is an algorithm so simple that even IEEE floating point math can't screw it up!

    I put this on npm as knuth-shuffle because fisher-yates-shuffle was just too long of a name and shuffle was already taken.

    Browser Example

    <script src="https://raw.github.com/coolaj86/knuth-shuffle/master/index.js"></script>
    (function () {
      'use strict';
     
      var a = [2,11,37,42];
      var b;
     
      // The shuffle modifies the original array
      // calling a.slice(0) creates a copy, which is assigned to b
      b = window.knuthShuffle(a.slice(0));
      console.log(b);
    }());

    Node Example

    Decentralized Install

    npm install --save git+https://git.coolaj86.com/coolaj86/knuth-shuffle.js.git#v1.0

    Centralized Install

    npm install --save knuth-shuffle@1.0
    (function () {
      'use strict';
     
      var shuffle = require('knuth-shuffle').knuthShuffle;
      var a = [2,11,37,42];
      var b;
     
      // The shuffle modifies the original array
      // calling a.slice(0) creates a copy, which is assigned to b
      b = shuffle(a.slice(0));
      console.log(b);
    }());

    Install

    npm i knuth-shuffle

    DownloadsWeekly Downloads

    15,724

    Version

    1.0.8

    License

    (MIT OR Apache-2.0)

    Last publish

    Collaborators

    • avatar