DOMPointReadOnly

The DOMPointReadOnly interface specifies the coordinate and perspective fields used by DOMPoint to define a 2D or 3D point in a coordinate system.

Note: This feature is available in Web Workers

There are two ways to create a new DOMPointReadOnly instance. First, you can use its constructor, passing in the values of the parameters for each dimension and, optionally, the perspective:

/* 2D */
const point = new DOMPointReadOnly(50, 50);

/* 3D */
const point = new DOMPointReadOnly(50, 50, 25);

/* 3D with perspective */
const point = new DOMPointReadOnly(100, 100, 100, 1.0);

The other option is to use the static DOMPointReadOnly.fromPoint() method:

const point = DOMPointReadOnly.fromPoint({x: 100, y: 100, z: 50; w: 1.0});

Constructor

DOMPointReadOnly()

Creates a new DOMPointReadOnly object given the values of its coordinates and perspective. To create a point using an object object, you can instead use DOMPointReadOnly.fromPoint().

Properties

DOMPointReadOnly.x Read only

The point's horizontal coordinate, x.

DOMPointReadOnly.y Read only

The point's vertical coordinate, y.

DOMPointReadOnly.z Read only

The point's depth coordinate, z.

DOMPointReadOnly.w Read only

The point's perspective value, w.

Static methods

DOMPointReadOnly.fromPoint()

A static method that creates a new DOMPointReadOnly object given the coordinates provided in the specified object.

Methods

matrixTransform()

Applies a matrix transform specified as an object to the DOMPointReadOnly object.

toJSON()

Returns a JSON representation of the DOMPointReadOnly object.

Specifications

Specification
Geometry Interfaces Module Level 1 (Geometry Interfaces 1)
# DOMPoint

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
DOMPointReadOnly
61
79
31
No
48
10.1
61
61
31
45
10.3
8.0
DOMPointReadOnly
61
79
62
No
48
10.1
61
61
62
45
10.3
8.0
fromPoint
61
79
62
No
48
10.1
61
61
62
45
10.3
8.0
matrixTransform
61
79
69
No
48
11
61
61
79
45
11
8.0
toJSON
61
79
62
No
48
10.1
61
61
62
45
10.3
8.0
w
61
79
31
No
48
10.1
61
61
31
45
10.3
8.0
worker_support
61
79
69
No
48
10.1
61
61
79
45
10.3
8.0
x
61
79
31
No
48
10.1
61
61
31
45
10.3
8.0
y
61
79
31
No
48
10.1
61
61
31
45
10.3
8.0
z
61
79
31
No
48
10.1
61
61
31
45
10.3
8.0

See also

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/DOMPointReadOnly