Crypto: Difference between revisions

Latest revision as of 16:48, 21 August 2012

This proposal has been subsumed by the window.crypto API in the Web Cryptography API being developed by the W3C Web Cryptography Working Group.

@@ Line 1: / Line 1: @@
-=Overview=
+This proposal has been subsumed by the <code>window.crypto</code> API in the [http://www.w3.org/2012/webcrypto/WebCryptoAPI/ Web Cryptography API] being developed by the W3C Web Cryptography Working Group.
-This document describes a proposal for the window.crypto API.
-=Interface=
-<pre>
-[Suplemental, NoInterfaceObject]
-interface Window {
-  readonly attribute Crypto crypto;
-};
-[NoInterfaceObject]
-interface Crypto {
-  void getRandomValues(in ArrayBufferView array);
-};
-</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''.  If ''array'' is not of an appropriate type, ''getRandomValues'' throws a [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-domexception-type_mismatch_err TYPE_MISMATCH_ERR].  If no ''cryptographically random values'' are available, ''getRandomValues'' throws a [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-domexception-not_supported_err NOT_SUPPORTED_ERR].