大网数据广告活动
Web 标准与前端开发

DOMMatrixReadOnly: toJSON() method

· 52CE 我爱测

The **`toJSON()`** method of the DOMMatrixReadOnly interface returns a JSON-serializable plain object representing the `DOMMatrixReadOnly` object.

DOM

The toJSON() method of the DOMMatrixReadOnly interface returns a JSON-serializable plain object representing the DOMMatrixReadOnly object.

The method is automatically called by JSON.stringify() when a DOMMatrixReadOnly object is encountered during JSON serialization. The serialized value can then be deserialized using the DOMMatrixReadOnly/fromMatrix_static function within the reviver of JSON.parse().

Syntax

toJSON()

Parameters

None.

Return value

A JSON-serializable plain object containing the following properties:

  • a
  • b
  • c
  • d
  • e
  • f
  • m11
  • m12
  • m13
  • m14
  • m21
  • m22
  • m23
  • m24
  • m31
  • m32
  • m33
  • m34
  • m41
  • m42
  • m43
  • m44
  • DOMMatrixReadOnly/is2D
  • DOMMatrixReadOnly/isIdentity

Each property's value is copied as-is.

Examples

Calling toJSON() directly

This example creates two DOMMatrixReadOnly objects: a 2D matrix and a 3D matrix. Calling toJSON() directly returns a plain object. Its properties have the same values as the corresponding properties of the original object.

const matrix = new DOMMatrixReadOnly("translate(20px, 30px)");
const matrix3D = new DOMMatrixReadOnly("translate3d(22px, 55px, 66px)");

const json = matrix.toJSON();
console.log(json); // A plain object
console.log(typeof json); // "object"
console.log(json.is2D); // Same value as matrix.is2D

Serializing to a JSON string

The DOMMatrixReadOnly object from the previous example is serialized using JSON.stringify(), which calls the toJSON() method automatically.

console.log(JSON.stringify(matrix));

This would log a JSON string like so (formatted for readability):

{
  "a": 1,
  "b": 0,
  "c": 0,
  "d": 1,
  "e": 20,
  "f": 30,
  "m11": 1,
  "m12": 0,
  "m13": 0,
  "m14": 0,
  "m21": 0,
  "m22": 1,
  "m23": 0,
  "m24": 0,
  "m31": 0,
  "m32": 0,
  "m33": 1,
  "m34": 0,
  "m41": 20,
  "m42": 30,
  "m43": 0,
  "m44": 1,
  "is2D": true,
  "isIdentity": false
}

The matrix3D object is three-dimensional, so it has is2D set to false:

console.log(JSON.stringify(matrix3D));

This would log a JSON string like so (formatted for readability):

{
  "a": 1,
  "b": 0,
  "c": 0,
  "d": 1,
  "e": 22,
  "f": 55,
  "m11": 1,
  "m12": 0,
  "m13": 0,
  "m14": 0,
  "m21": 0,
  "m22": 1,
  "m23": 0,
  "m24": 0,
  "m31": 0,
  "m32": 0,
  "m33": 1,
  "m34": 0,
  "m41": 22,
  "m42": 55,
  "m43": 66,
  "m44": 1,
  "is2D": false,
  "isIdentity": false
}

Specifications

Browser compatibility

See also

  • DOMMatrixReadOnly.toString()
  • DOMMatrix.setMatrixValue()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。