feat:node-modules
This commit is contained in:
houjunxiang
322
node_modules/seedrandom/README.md
generated
vendored
Normal file
322
node_modules/seedrandom/README.md
generated
vendored
Normal file
@@ -0,0 +1,322 @@
|
||||
seedrandom.js
|
||||
=============
|
||||
[](https://travis-ci.org/davidbau/seedrandom)
|
||||
[](http://badge.fury.io/js/seedrandom)
|
||||
[](http://badge.fury.io/bo/seedrandom)
|
||||
|
||||
Seeded random number generator for JavaScript.
|
||||
|
||||
Version 3.0.5
|
||||
|
||||
Author: David Bau
|
||||
|
||||
Date: 2019-09-14
|
||||
|
||||
Can be used as a plain script, a Node.js module or an AMD module.
|
||||
|
||||
|
||||
Script tag usage
|
||||
----------------
|
||||
|
||||
```html
|
||||
<script src="//cdnjs.cloudflare.com/ajax/libs/seedrandom/3.0.5/seedrandom.min.js">
|
||||
</script>
|
||||
```
|
||||
|
||||
```js
|
||||
// Make a predictable pseudorandom number generator.
|
||||
var myrng = new Math.seedrandom('hello.');
|
||||
console.log(myrng()); // Always 0.9282578795792454
|
||||
console.log(myrng()); // Always 0.3752569768646784
|
||||
|
||||
// Use "quick" to get only 32 bits of randomness in a float.
|
||||
console.log(myrng.quick()); // Always 0.7316977467853576
|
||||
|
||||
// Use "int32" to get a 32 bit (signed) integer
|
||||
console.log(myrng.int32()); // Always 1966374204
|
||||
|
||||
// Calling seedrandom with no arguments creates an ARC4-based PRNG
|
||||
// that is autoseeded using the current time, dom state, and other
|
||||
// accumulated local entropy.
|
||||
var prng = new Math.seedrandom();
|
||||
console.log(prng()); // Reasonably unpredictable.
|
||||
|
||||
// Seeds using the given explicit seed mixed with accumulated entropy.
|
||||
prng = new Math.seedrandom('added entropy.', { entropy: true });
|
||||
console.log(prng()); // As unpredictable as added entropy.
|
||||
|
||||
// Warning: if you call Math.seedrandom without `new`, it replaces
|
||||
// Math.random with the predictable new Math.seedrandom(...), as follows:
|
||||
Math.seedrandom('hello.');
|
||||
console.log(Math.random()); // Always 0.9282578795792454
|
||||
console.log(Math.random()); // Always 0.3752569768646784
|
||||
|
||||
```
|
||||
|
||||
**Note**: calling `Math.seedrandom('constant')` without `new` will make
|
||||
`Math.random()` predictable globally, which is intended to be useful for
|
||||
derandomizing code for testing, but should not be done in a production library.
|
||||
If you need a local seeded PRNG, use `myrng = new Math.seedrandom('seed')`
|
||||
instead. For example, [cryptico](https://www.npmjs.com/package/cryptico),
|
||||
an RSA encryption package, [uses the wrong form](
|
||||
https://github.com/wwwtyro/cryptico/blob/9291ece6/api.js#L264),
|
||||
and thus secretly makes `Math.random()` perfectly predictable.
|
||||
The cryptico library (and any other library that does this)
|
||||
should not be trusted in a security-sensitive application.
|
||||
|
||||
|
||||
Other Fast PRNG Algorithms
|
||||
--------------------------
|
||||
|
||||
The package includes some other fast PRNGs. To use Johannes Baagøe's
|
||||
extremely fast Alea PRNG:
|
||||
|
||||
|
||||
```html
|
||||
<script src="//cdnjs.cloudflare.com/ajax/libs/seedrandom/3.0.5/lib/alea.min.js">
|
||||
</script>
|
||||
```
|
||||
|
||||
```js
|
||||
// Use alea for Johannes Baagøe's clever and fast floating-point RNG.
|
||||
var arng = new alea('hello.');
|
||||
|
||||
// By default provides 32 bits of randomness in a float.
|
||||
console.log(arng()); // Always 0.4783254903741181
|
||||
|
||||
// Use "double" to get 56 bits of randomness.
|
||||
console.log(arng.double()); // Always 0.8297006866124559
|
||||
|
||||
// Use "int32" to get a 32 bit (signed) integer.
|
||||
console.log(arng.int32()); // Always 1076136327
|
||||
```
|
||||
|
||||
Besides alea, there are several other faster PRNGs available.
|
||||
Note that none of these fast PRNGs provide autoseeding: you
|
||||
need to provide your own seed (or use the default autoseeded
|
||||
seedrandom to make a seed).
|
||||
|
||||
|PRNG name | Time vs native | Period | Author |
|
||||
|-----------|----------------|-------------|----------------------|
|
||||
|`alea` | 1.95 ns, 0.9x | ~2^116 | Baagøe |
|
||||
|`xor128` | 2.04 ns, 0.9x | 2^128-1 | Marsaglia |
|
||||
|`tychei` | 2.32 ns, 1.1x | ~2^127 | Neves/Araujo (ChaCha)|
|
||||
|`xorwow` | 2.40 ns, 1.1x | 2^192-2^32 | Marsaglia |
|
||||
|`xor4096` | 2.40 ns, 1.1x | 2^4096-2^32 | Brent (xorgens) |
|
||||
|`xorshift7`| 2.64 ns, 1.3x | 2^256-1 | Panneton/L'ecuyer |
|
||||
|`quick` | 3.80 ns, 1.8x | ~2^1600 | Bau (ARC4) |
|
||||
|
||||
(Timings were done on node v0.12.2 on a single-core Google Compute Engine
|
||||
instance. `quick` is just the 32-bit version of the RC4-based PRNG
|
||||
originally packaged with seedrandom.)
|
||||
|
||||
|
||||
CJS / Node.js usage
|
||||
-------------------
|
||||
|
||||
```
|
||||
npm install seedrandom
|
||||
```
|
||||
|
||||
```js
|
||||
// Local PRNG: does not affect Math.random.
|
||||
var seedrandom = require('seedrandom');
|
||||
var rng = seedrandom('hello.');
|
||||
console.log(rng()); // Always 0.9282578795792454
|
||||
|
||||
// Global PRNG: set Math.random.
|
||||
seedrandom('hello.', { global: true });
|
||||
console.log(Math.random()); // Always 0.9282578795792454
|
||||
|
||||
// Autoseeded ARC4-based PRNG.
|
||||
rng = seedrandom();
|
||||
console.log(rng()); // Reasonably unpredictable.
|
||||
|
||||
// Mixing accumulated entropy.
|
||||
rng = seedrandom('added entropy.', { entropy: true });
|
||||
console.log(rng()); // As unpredictable as added entropy.
|
||||
|
||||
// Using alternate algorithms, as listed above.
|
||||
var rng2 = seedrandom.xor4096('hello.')
|
||||
console.log(rng2());
|
||||
```
|
||||
|
||||
Starting in version 3, when using via require('seedrandom'), the global
|
||||
`Math.seedrandom` is no longer available.
|
||||
|
||||
|
||||
Require.js usage
|
||||
----------------
|
||||
|
||||
Similar to Node.js usage:
|
||||
|
||||
```
|
||||
bower install seedrandom
|
||||
```
|
||||
|
||||
```
|
||||
require(['seedrandom'], function(seedrandom) {
|
||||
var rng = seedrandom('hello.');
|
||||
console.log(rng()); // Always 0.9282578795792454
|
||||
});
|
||||
```
|
||||
|
||||
|
||||
Network seeding
|
||||
---------------
|
||||
|
||||
```html
|
||||
<script src=//cdnjs.cloudflare.com/ajax/libs/seedrandom/3.0.5/seedrandom.min.js>
|
||||
</script>
|
||||
<!-- Seeds using urandom bits from a server. -->
|
||||
<script src=//jsonlib.appspot.com/urandom?callback=Math.seedrandom>
|
||||
</script>
|
||||
|
||||
<!-- Seeds mixing in random.org bits -->
|
||||
<script>
|
||||
(function(x, u, s){
|
||||
try {
|
||||
// Make a synchronous request to random.org.
|
||||
x.open('GET', u, false);
|
||||
x.send();
|
||||
s = unescape(x.response.trim().replace(/^|\s/g, '%'));
|
||||
} finally {
|
||||
// Seed with the response, or autoseed on failure.
|
||||
Math.seedrandom(s, !!s);
|
||||
}
|
||||
})(new XMLHttpRequest, 'https://www.random.org/integers/' +
|
||||
'?num=256&min=0&max=255&col=1&base=16&format=plain&rnd=new');
|
||||
</script>
|
||||
```
|
||||
|
||||
Reseeding using user input
|
||||
--------------------------
|
||||
|
||||
```js
|
||||
var seed = Math.seedrandom(); // Use prng with an automatic seed.
|
||||
document.write(Math.random()); // Pretty much unpredictable x.
|
||||
|
||||
var rng = new Math.seedrandom(seed); // A new prng with the same seed.
|
||||
document.write(rng()); // Repeat the 'unpredictable' x.
|
||||
|
||||
function reseed(event, count) { // Define a custom entropy collector.
|
||||
var t = [];
|
||||
function w(e) {
|
||||
t.push([e.pageX, e.pageY, +new Date]);
|
||||
if (t.length < count) { return; }
|
||||
document.removeEventListener(event, w);
|
||||
Math.seedrandom(t, { entropy: true });
|
||||
}
|
||||
document.addEventListener(event, w);
|
||||
}
|
||||
reseed('mousemove', 100); // Reseed after 100 mouse moves.
|
||||
```
|
||||
|
||||
The "pass" option can be used to get both the prng and the seed.
|
||||
The following returns both an autoseeded prng and the seed as an object,
|
||||
without mutating Math.random:
|
||||
|
||||
```js
|
||||
var obj = Math.seedrandom(null, { pass: function(prng, seed) {
|
||||
return { random: prng, seed: seed };
|
||||
}});
|
||||
```
|
||||
|
||||
|
||||
Saving and Restoring PRNG state
|
||||
-------------------------------
|
||||
|
||||
```js
|
||||
var seedrandom = Math.seedrandom;
|
||||
var saveable = seedrandom("secret-seed", {state: true});
|
||||
for (var j = 0; j < 1e5; ++j) saveable();
|
||||
var saved = saveable.state();
|
||||
var replica = seedrandom("", {state: saved});
|
||||
assert(replica() == saveable());
|
||||
```
|
||||
|
||||
In normal use the prng is opaque and its internal state cannot be accessed.
|
||||
However, if the "state" option is specified, the prng gets a state() method
|
||||
that returns a plain object the can be used to reconstruct a prng later in
|
||||
the same state (by passing that saved object back as the state option).
|
||||
|
||||
|
||||
Version notes
|
||||
-------------
|
||||
|
||||
The random number sequence is the same as version 1.0 for string seeds.
|
||||
|
||||
* Version 2.0 changed the sequence for non-string seeds.
|
||||
* Version 2.1 speeds seeding and uses window.crypto to autoseed if present.
|
||||
* Version 2.2 alters non-crypto autoseeding to sweep up entropy from plugins.
|
||||
* Version 2.3 adds support for "new", module loading, and a null seed arg.
|
||||
* Version 2.3.1 adds a build environment, module packaging, and tests.
|
||||
* Version 2.3.4 fixes bugs on IE8, and switches to MIT license.
|
||||
* Version 2.3.6 adds a readable options object argument.
|
||||
* Version 2.3.10 adds support for node.js crypto (contributed by ctd1500).
|
||||
* Version 2.3.11 adds an option to load and save internal state.
|
||||
* Version 2.4.0 adds implementations of several other fast PRNGs.
|
||||
* Version 2.4.2 adds an implementation of Baagoe's very fast Alea PRNG.
|
||||
* Version 2.4.3 ignores nodejs crypto when under browserify.
|
||||
* Version 2.4.4 avoids strict mode problem with global this reference.
|
||||
* Version 3.0.1 removes Math.seedrandom for require('seedrandom') users.
|
||||
* Version 3.0.3 updates package.json for CDN entrypoints.
|
||||
* Version 3.0.5 removes eval to avoid triggering content-security policy.
|
||||
|
||||
The standard ARC4 key scheduler cycles short keys, which means that
|
||||
seedrandom('ab') is equivalent to seedrandom('abab') and 'ababab'.
|
||||
Therefore it is a good idea to add a terminator to avoid trivial
|
||||
equivalences on short string seeds, e.g., Math.seedrandom(str + '\0').
|
||||
Starting with version 2.0, a terminator is added automatically for
|
||||
non-string seeds, so seeding with the number 111 is the same as seeding
|
||||
with '111\0'.
|
||||
|
||||
When seedrandom() is called with zero args or a null seed, it uses a
|
||||
seed drawn from the browser crypto object if present. If there is no
|
||||
crypto support, seedrandom() uses the current time, the native rng,
|
||||
and a walk of several DOM objects to collect a few bits of entropy.
|
||||
|
||||
Each time the one- or two-argument forms of seedrandom are called,
|
||||
entropy from the passed seed is accumulated in a pool to help generate
|
||||
future seeds for the zero- and two-argument forms of seedrandom.
|
||||
|
||||
On speed - This javascript implementation of Math.random() is several
|
||||
times slower than the built-in Math.random() because it is not native
|
||||
code, but that is typically fast enough. Some details (timings on
|
||||
Chrome 25 on a 2010 vintage macbook):
|
||||
|
||||
* seeded Math.random() - avg less than 0.0002 milliseconds per call
|
||||
* seedrandom('explicit.') - avg less than 0.2 milliseconds per call
|
||||
* seedrandom('explicit.', true) - avg less than 0.2 milliseconds per call
|
||||
* seedrandom() with crypto - avg less than 0.2 milliseconds per call
|
||||
|
||||
Autoseeding without crypto is somewhat slow, about 20-30 milliseconds on
|
||||
a 2012 windows 7 1.5ghz i5 laptop, as seen on Firefox 19, IE 10, and Opera.
|
||||
Seeded rng calls themselves are fast across these browsers, with slowest
|
||||
numbers on Opera at about 0.0005 ms per seeded Math.random().
|
||||
|
||||
|
||||
LICENSE (MIT)
|
||||
-------------
|
||||
|
||||
Copyright 2019 David Bau.
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining
|
||||
a copy of this software and associated documentation files (the
|
||||
"Software"), to deal in the Software without restriction, including
|
||||
without limitation the rights to use, copy, modify, merge, publish,
|
||||
distribute, sublicense, and/or sell copies of the Software, and to
|
||||
permit persons to whom the Software is furnished to do so, subject to
|
||||
the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be
|
||||
included in all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
||||
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
||||
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
||||
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
||||
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
||||
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
||||
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
|
||||
Reference in New Issue
Block a user