microsoft / microsoft/TypeScript

`IntegerTypedArray` type required for use with `crypto.getRandomValues`

Abierto
#61,768 2 comentarios 2 reacciones 3 asignados Ver en GitHub

@RyanCavanaugh ya está trabajando en esto.

Desde el 19/9/2026.

  • #64343 de @copilot-swe-agent — abierto
Bug Domain: lib.d.ts Needs Human Review
Lenguaje dominante
Go
Estrellas
111k
Forks
14.3k
Merge medio
2 d 4 h
PR fusionados (30 d)
132

Descripción

### ⚙ Compilation target

any

### ⚙ Library

latest

### Missing / Incorrect Definition

The current DOM types `` [are wrong](https://github.com/microsoft/TypeScript-DOM-lib-generator/issues/1194) for `crypto.getRandomValues`. `null` is never accepted, and `ArrayBufferView` is too broad as float arrays also aren't accepted.

However, [fixing](https://github.com/microsoft/TypeScript-DOM-lib-generator/pull/2028) in `TypeScript-DOM-lib-generator` requires conditional inclusion of `BigInt64Array | BigUint64Array` depending on ES2020 availability. I don't think there's a way to fix that within `TypeScript-DOM-lib-generator` without this upstream change in `TypeScript`.

`es5.d.ts`:

```ts
interface IntegerTypedArrayTypes {
Int8Array: Int8Array;
Int16Array: Int16Array;
Int32Array: Int32Array;
Uint8Array: Uint8Array;
Uint16Array: Uint16Array;
Uint32Array: Uint32Array;
Uint8ClampedArray: Uint8ClampedArray;
}

type IntegerTypedArray = IntegerTypedArrayTypes[keyof IntegerTypedArrayTypes];
```

`es2020.bigint.d.ts`:

```ts
interface IntegerTypedArrayTypes {
BigInt64Array: BigInt64Array;
BigUint64Array: BigUint64Array;
}
```

### Sample Code

```TypeScript
// Unused '@ts-expect-error' directive.(2578)
// @ts-expect-error
crypto.getRandomValues(null)
// Unused '@ts-expect-error' directive.(2578)
// @ts-expect-error
crypto.getRandomValues(new Float64Array())

declare const arr: Parameters[0]
const values = crypto.getRandomValues(arr)

// 'values' is possibly 'null'.(18047)
values.BYTES_PER_ELEMENT

// Property 'BYTES_PER_ELEMENT' does not exist on type 'ArrayBufferView'.(2339)
values!.BYTES_PER_ELEMENT
```

### Documentation Link

[10.1.1 The getRandomValues method - Web Cryptography Level 2](https://www.w3.org/TR/webcrypto/#dfn-Crypto-method-getRandomValues)

> If array is not an Int8Array, Uint8Array, Uint8ClampedArray, Int16Array, Uint16Array, Int32Array, Uint32Array, BigInt64Array, or BigUint64Array, then throw a TypeMismatchError and terminate the algorithm.

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Evaluación

Este issue todavía no se ha evaluado.

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.