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 aDOMPointInit 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 DOMPointInit object.

Methods

matrixTransform()
Applies a matrix transform specified as a DOMMatrixInit object to the DOMPointReadOnly object.
toJSON()
Returns a JSON representation of the DOMPointReadOnly object.

Specifications

Specification Status Comment
Geometry Interfaces Module Level 1
The definition of 'DOMPoint' in that specification.
Candidate Recommendation Latest spec version is an ED.

Browser compatibility

BCD tables only load in the browser

See also