DOMMatrixReadOnly: multiply() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Note: This feature is available in Web Workers.

The multiply() method of the DOMMatrixReadOnly interface creates and returns a new matrix which is the dot product of the matrix and the otherMatrix parameter. If otherMatrix is omitted, the matrix is multiplied by a matrix in which every element is 0 except the bottom-right corner and the element immediately above and to its left: m33 and m34. These have the default value of 1. The original matrix is not modified.

To mutate the matrix as you multiply it, see DOMMatrix.multiplySelf().

Syntax

js
  DOMMatrixReadOnly.multiply()
  DOMMatrixReadOnly.multiply(otherMatrix)

Parameters

otherMatrix Optional

The DOMMatrix multiplier.

Return value

A DOMMatrix.

Examples

js
const matrix = new DOMMatrixReadOnly().translate(13, 21);
const multipliedMatrix = matrix.multiply(matrix);
console.log(matrix.toString()); // output: matrix(1, 0, 0, 1, 13, 21)
console.log(multipliedMatrix.toString()); // output: matrix(1, 0, 0, 1, 26, 42)

Specifications

Specification
Geometry Interfaces Module Level 1
# dom-dommatrixreadonly-multiply

Browser compatibility

BCD tables only load in the browser

See also