Crypto

2011-05-25T21:44:11Z

BrendanEich: fix typo

=Overview=

This document describes a proposal for the window.crypto API.

=Definitions=

==Cryptographically Random Values==

A ''cryptographically random value'' is a value generated from a cryptographically strong pseudo-random number generator seeded with truly random values. In practice, implementations should generate cryptographically random values using well-established cryptographic pseudo-random number generators, such as RC4, seeded with high-quality entropy, such as from an operating-system entropy source (e.g., ''/dev/urandom''). This document provides no lower-bound on the information theoretic entropy present in cryptographically random values, but implementations should make a best effort to provide as much entropy as practicable.

=Interface=

<pre>
[NoInterfaceObject]
interface Crypto {
void getRandomValues(in ArrayBufferView array);
};

[Supplemental, NoInterfaceObject]
interface Window {
readonly attribute Crypto crypto;
};
</pre>

=Methods=

==getRandomValues==

The ''getRandomValues'' method fills ''array'' with random data. Specifically, if ''array'' is an [http://www.khronos.org/registry/typedarray/specs/latest/#6 ArrayBufferView] of an integer type (i.e., Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array, or Uint32Array), then all the elements of ''array'' are overwritten with ''cryptographically random values'' of the appropriate type. If ''array'' is not of an integer type, ''getRandomValues'' throws a [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-domexception-type_mismatch_err TYPE_MISMATCH_ERR].

[[Category:Proposals]]

WHATWG Wiki - User contributions [en]

Crypto