DOMPointReadOnly: DOMPointReadOnly() constructor

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 DOMPointReadOnly() constructor returns a new DOMPointReadOnly object representing a point in 2D or 3D space, optionally with perspective, whose values cannot be altered by script code.

Syntax

js
new DOMPointReadOnly()
new DOMPointReadOnly(x)
new DOMPointReadOnly(x, y)
new DOMPointReadOnly(x, y, z)
new DOMPointReadOnly(x, y, z, w)

Parameters

x Optional

The value of the horizontal coordinate, x, as a floating point number. The default value is 0.

y Optional

The value of the vertical coordinate, y, as a floating point number. The default value is 0.

z Optional

The value of the depth coordinate, z, as a floating point number. The default value is 0.

w Optional

The value of the perspective, w, as a floating point number. The default is 1.

Note: Each of these values is what's called an unrestricted number. In addition to any finite floating-point value, you may use special values such as ±Infinity and NaN.

Return value

A new DOMPointReadOnly object representing the specified location in space.

Examples

The following code demonstrates creating both 2D and 3D points.

js
const point2D = new DOMPointReadOnly(50, 25);
const point3D = new DOMPointReadOnly(50, 0, 10);
const perspectivePoint3D = new DOMPointReadOnly(50, 50, 25, 0.5);

Specifications

Specification
Geometry Interfaces Module Level 1
# dom-dompointreadonly-dompointreadonly

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
DOMPointReadOnly() constructor

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support