W3cubDocs

/Web APIs

DOMPointReadOnly: DOMPointReadOnly() constructor

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

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 62 No 48 10.1 61 61 62 45 10.3 8.0

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