Split TypedArray overload into separate overloads

lib Update Request

Configuration Check

My compilation target is ESNext and my lib is the default.

Missing / Incorrect Definition

All TypedArrays have five overloads, one of which is the following:

TypedArray(buffer: ArrayBuffer, byteOffset?: number, length?: number);

I believe that this should be split into three separate overloads:

new TypedArray(buffer: ArrayBuffer);
new TypedArray(buffer: ArrayBuffer, byteOffset: number);
new TypedArray(buffer: ArrayBuffer, byteOffset: number, length: number);

or

new TypedArray(buffer: ArrayBuffer, byteOffset?: number);
new TypedArray(buffer: ArrayBuffer, byteOffset: number, length: number);

Sample Code

I came across something vaguely like this:

declare function getOffset(): undefined;

const offset = getOffset();

new Uint8Array(new ArrayBuffer(0), offset, 0);

and thought that their code definitely had a bug, but, it turns out that undefined-ish values were allowed for the second parameter, because the type was of number | undefined.

This would break code, but I believe that this will break little to no code in practice.

Documentation Link

N/A: no new additions

Inizia dalle dichiarazioni dei costruttori di TypedArray descritte nell’issue e riproduci l’esempio in cui viene accettato un offset undefined. Confronta gli overload esistenti con le arities separate proposte, quindi verifica che le chiamate valide al costruttore continuino a essere verificate dal sistema dei tipi, mentre la chiamata a tre argomenti con un offset undefined venga rifiutata.