// Copyright (c) Jupyter Development Team. // Distributed under the terms of the Modified BSD License. /*----------------------------------------------------------------------------- | Copyright (c) 2014-2017, PhosphorJS Contributors | | Distributed under the terms of the BSD 3-Clause License. | | The full license is in the file LICENSE, distributed with this software. |----------------------------------------------------------------------------*/ import { fallbackRandomValues } from './random'; // Declare ambient variables for `window` and `require` to avoid a // hard dependency on both. This package must run on node. declare let require: any; /** * The namespace for random number related functionality. */ export namespace Random { /** * A function which generates random bytes. * * @param buffer - The `Uint8Array` to fill with random bytes. * * #### Notes * A cryptographically strong random number generator will be used if * available. Otherwise, `Math.random` will be used as a fallback for * randomness. * * The following RNGs are supported, listed in order of precedence: * - `window.crypto.getRandomValues` * - `window.msCrypto.getRandomValues` * - `require('crypto').randomFillSync * - `require('crypto').randomBytes * - `Math.random` */ export const getRandomValues = (() => { // Look up the crypto module if available. const crypto: any = (typeof require !== 'undefined' && require('crypto')) || null; // Node 7+ if (crypto && typeof crypto.randomFillSync === 'function') { return function getRandomValues(buffer: Uint8Array): void { return crypto.randomFillSync(buffer); }; } // Node 0.10+ if (crypto && typeof crypto.randomBytes === 'function') { return function getRandomValues(buffer: Uint8Array): void { let bytes = crypto.randomBytes(buffer.length); for (let i = 0, n = bytes.length; i < n; ++i) { buffer[i] = bytes[i]; } }; } // Fallback return fallbackRandomValues; })(); }