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

Start at the TypedArray constructor declarations described in the issue and reproduce the sample where an undefined offset is accepted. Compare the existing overloads with the proposed separate arities, then verify that valid constructor calls still type-check while the three-argument call with an undefined offset is rejected.