Add crypto.getRandomValues() (#2327)

js/get_random_values.ts

@@ -0,0 +1,35 @@
+// Copyright 2018-2019 the Deno authors. All rights reserved. MIT license.
+import * as msg from "gen/cli/msg_generated";
+import * as flatbuffers from "./flatbuffers";
+import * as dispatch from "./dispatch";
+import { assert } from "./util";
+
+function req(
+  typedArray: ArrayBufferView
+): [flatbuffers.Builder, msg.Any, flatbuffers.Offset, ArrayBufferView] {
+  const builder = flatbuffers.createBuilder();
+  const inner = msg.GetRandomValues.createGetRandomValues(builder);
+  return [builder, msg.Any.GetRandomValues, inner, typedArray];
+}
+
+/** Synchronously collects cryptographically secure random values. The
+ * underlying CSPRNG in use is Rust's `rand::rngs::ThreadRng`.
+ *
+ *       const arr = new Uint8Array(32);
+ *       crypto.getRandomValues(arr);
+ */
+export function getRandomValues<
+  T extends
+    | Int8Array
+    | Uint8Array
+    | Uint8ClampedArray
+    | Int16Array
+    | Uint16Array
+    | Int32Array
+    | Uint32Array
+>(typedArray: T): T {
+  assert(typedArray !== null, "Input must not be null");
+  assert(typedArray.length <= 65536, "Input must not be longer than 65536");
+  dispatch.sendSync(...req(typedArray as ArrayBufferView));
+  return typedArray;
+}

js/get_random_values_test.ts

@@ -0,0 +1,51 @@
+// Copyright 2018-2019 the Deno authors. All rights reserved. MIT license.
+import { test, assertNotEquals, assertStrictEq } from "./test_util.ts";
+
+test(function getRandomValuesInt8Array(): void {
+  const arr = new Int8Array(32);
+  crypto.getRandomValues(arr);
+  assertNotEquals(arr, new Int8Array(32));
+});
+
+test(function getRandomValuesUint8Array(): void {
+  const arr = new Uint8Array(32);
+  crypto.getRandomValues(arr);
+  assertNotEquals(arr, new Uint8Array(32));
+});
+
+test(function getRandomValuesUint8ClampedArray(): void {
+  const arr = new Uint8ClampedArray(32);
+  crypto.getRandomValues(arr);
+  assertNotEquals(arr, new Uint8ClampedArray(32));
+});
+
+test(function getRandomValuesInt16Array(): void {
+  const arr = new Int16Array(4);
+  crypto.getRandomValues(arr);
+  assertNotEquals(arr, new Int16Array(4));
+});
+
+test(function getRandomValuesUint16Array(): void {
+  const arr = new Uint16Array(4);
+  crypto.getRandomValues(arr);
+  assertNotEquals(arr, new Uint16Array(4));
+});
+
+test(function getRandomValuesInt32Array(): void {
+  const arr = new Int32Array(8);
+  crypto.getRandomValues(arr);
+  assertNotEquals(arr, new Int32Array(8));
+});
+
+test(function getRandomValuesUint32Array(): void {
+  const arr = new Uint32Array(8);
+  crypto.getRandomValues(arr);
+  assertNotEquals(arr, new Uint32Array(8));
+});
+
+test(function getRandomValuesReturnValue(): void {
+  const arr = new Uint32Array(8);
+  const rtn = crypto.getRandomValues(arr);
+  assertNotEquals(arr, new Uint32Array(8));
+  assertStrictEq(rtn, arr);
+});

js/globals.ts

@@ -10,6 +10,7 @@
 import { window } from "./window";
 import * as blob from "./blob";
 import * as consoleTypes from "./console";
+import * as csprng from "./get_random_values";
 import * as customEvent from "./custom_event";
 import * as deno from "./deno";
 import * as domTypes from "./dom_types";
@@ -69,6 +70,10 @@ window.console = console;
 window.setTimeout = timers.setTimeout;
 window.setInterval = timers.setInterval;
 window.location = (undefined as unknown) as domTypes.Location;
+// The following Crypto interface implementation is not up to par with the
+// standard https://www.w3.org/TR/WebCryptoAPI/#crypto-interface as it does not
+// yet incorporate the SubtleCrypto interface as its "subtle" property.
+window.crypto = (csprng as unknown) as Crypto;
 
 // When creating the runtime type library, we use modifications to `window` to
 // determine what is in the global namespace.  When we put a class in the
@@ -135,3 +140,19 @@ export interface ImportMeta {
   url: string;
   main: boolean;
 }
+
+export interface Crypto {
+  readonly subtle: null;
+  getRandomValues: <
+    T extends
+      | Int8Array
+      | Uint8Array
+      | Uint8ClampedArray
+      | Int16Array
+      | Uint16Array
+      | Int32Array
+      | Uint32Array
+  >(
+    typedArray: T
+  ) => T;
+}

js/test_util.ts

@@ -14,7 +14,9 @@ import {
 } from "./deps/https/deno.land/std/testing/asserts.ts";
 export {
   assert,
-  assertEquals
+  assertEquals,
+  assertNotEquals,
+  assertStrictEq
 } from "./deps/https/deno.land/std/testing/asserts.ts";
 
 interface TestPermissions {

js/unit_tests.ts

@@ -19,6 +19,7 @@ import "./fetch_test.ts";
 import "./file_test.ts";
 import "./files_test.ts";
 import "./form_data_test.ts";
+import "./get_random_values_test.ts";
 import "./globals_test.ts";
 import "./headers_test.ts";
 import "./link_test.ts";