123456789101112131415161718192021222324252627282930313233343536 |
- /**
- * A **Cryptographically Secure Random Value** is one that has been
- * generated with additional care take to prevent side-channels
- * from allowing others to detect it and prevent others from through
- * coincidence generate the same values.
- *
- * @_subsection: api/crypto:Random Values [about-crypto-random]
- */
- import { randomBytes as crypto_random } from "./crypto.js";
- let locked = false;
- const _randomBytes = function(length: number): Uint8Array {
- return new Uint8Array(crypto_random(length));
- }
- let __randomBytes = _randomBytes;
- /**
- * Return %%length%% bytes of cryptographically secure random data.
- *
- * @example:
- * randomBytes(8)
- * //_result:
- */
- export function randomBytes(length: number): Uint8Array {
- return __randomBytes(length);
- }
- randomBytes._ = _randomBytes;
- randomBytes.lock = function(): void { locked = true; }
- randomBytes.register = function(func: (length: number) => Uint8Array) {
- if (locked) { throw new Error("randomBytes is locked"); }
- __randomBytes = func;
- }
- Object.freeze(randomBytes);
|