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

Beginne bei den in der Issue beschriebenen Deklarationen der TypedArray-Konstruktoren und reproduziere das Beispiel, bei dem ein undefinierter offset akzeptiert wird. Vergleiche die vorhandenen overloads mit den vorgeschlagenen separaten arities und überprüfe anschließend, dass gültige Konstruktoraufrufe weiterhin typgeprüft werden, während der Aufruf mit drei Argumenten und einem undefined offset abgelehnt wird.