lib.dom: DOMatrix constructor accepts TypedArrays, not only Arrays.

[trusktr]

⚙ Compilation target

n/a

⚙ Library

lib.dom

Missing / Incorrect Definition

DOMMatrix and DOMMatrixReadonly constructors are typed as accepting only number[] but they also accept TypedArrays in all browsers.

The following code works in all browsers:

Sample Code

new DOMMatrix(new Float32Array(16))

Documentation Link

The MDN documentation doesn't really mention this detail, and the spec mentions a "sequence" which to me isn't very specific. Isn't a TypedArray a "sequence of numbers"?

Perhaps the type should probably be ArrayLike<number>.

[trusktr]

Besides this, DOMMatrix has toFloat32Array and toFloat64Array methods, and not a toArray method. Makes sense to be able to pass typed arrays if it can also return typed arrays. I've also opened an issue with the spec to add toArray.

[Jamesernator]

The MDN documentation doesn't really mention this detail, and the spec mentions a "sequence" which to me isn't very specific. Isn't a TypedArray a "sequence of numbers"?

A sequence in WebIDL is just an iterable.

The lib generator seems to be missing emitting iterable signatures for constructors.