Web/API/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 1The definition of 'DOMPoint' in that specification.	Candidate Recommendation	Latest spec version is an ED.

Browser compatibility

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
DOMPointReadOnly	Chrome Full support 61	Edge Full support 79	Firefox Full support 31	IE No support No	Opera Full support 48	Safari Full support 10.1	WebView Android Full support 61	Chrome Android Full support 61	Firefox Android Full support 31	Opera Android Full support 45	Safari iOS Full support 10.3	Samsung Internet Android Full support 8.0
DOMPointReadOnly() constructor	Chrome Full support 61	Edge Full support 79	Firefox Full support 62	IE No support No	Opera Full support 48	Safari Full support 10.1	WebView Android Full support 61	Chrome Android Full support 61	Firefox Android Full support 62	Opera Android Full support 45	Safari iOS Full support 10.3	Samsung Internet Android Full support 8.0
fromPoint() static function	Chrome Full support 61	Edge Full support 79	Firefox Full support 62	IE No support No	Opera Full support 48	Safari Full support 10.1	WebView Android Full support 61	Chrome Android Full support 61	Firefox Android Full support 62	Opera Android Full support 45	Safari iOS Full support 10.3	Samsung Internet Android Full support 8.0
matrixTransform() Deprecated'	Chrome Full support 61	Edge Full support 79	Firefox Full support 69	IE No support No	Opera Full support 48	Safari Full support 11	WebView Android Full support 61	Chrome Android Full support 61	Firefox Android Full support 79	Opera Android Full support 45	Safari iOS Full support 11	Samsung Internet Android Full support 8.0
toJSON()	Chrome Full support 61	Edge Full support 79	Firefox Full support 62	IE No support No	Opera Full support 48	Safari Full support 10.1	WebView Android Full support 61	Chrome Android Full support 61	Firefox Android Full support 62	Opera Android Full support 45	Safari iOS Full support 10.3	Samsung Internet Android Full support 8.0
w	Chrome Full support 61	Edge Full support 79	Firefox Full support 31	IE No support No	Opera Full support 48	Safari Full support 10.1	WebView Android Full support 61	Chrome Android Full support 61	Firefox Android Full support 31	Opera Android Full support 45	Safari iOS Full support 10.3	Samsung Internet Android Full support 8.0
Available in workers	Chrome Full support 61	Edge Full support 79	Firefox Full support 69	IE No support No	Opera Full support 48	Safari Full support 10.1	WebView Android Full support 61	Chrome Android Full support 61	Firefox Android Full support 79	Opera Android Full support 45	Safari iOS Full support 10.3	Samsung Internet Android Full support 8.0
x	Chrome Full support 61	Edge Full support 79	Firefox Full support 31	IE No support No	Opera Full support 48	Safari Full support 10.1	WebView Android Full support 61	Chrome Android Full support 61	Firefox Android Full support 31	Opera Android Full support 45	Safari iOS Full support 10.3	Samsung Internet Android Full support 8.0
y	Chrome Full support 61	Edge Full support 79	Firefox Full support 31	IE No support No	Opera Full support 48	Safari Full support 10.1	WebView Android Full support 61	Chrome Android Full support 61	Firefox Android Full support 31	Opera Android Full support 45	Safari iOS Full support 10.3	Samsung Internet Android Full support 8.0
z	Chrome Full support 61	Edge Full support 79	Firefox Full support 31	IE No support No	Opera Full support 48	Safari Full support 10.1	WebView Android Full support 61	Chrome Android Full support 61	Firefox Android Full support 31	Opera Android Full support 45	Safari iOS Full support 10.3	Samsung Internet Android Full support 8.0

Legend

Full support  

Full support

No support  

No support

Deprecated. Not for use in new websites.'

Deprecated. Not for use in new websites.

See also

• DOMPoint
• DOMRect
• DOMMatrix

DOMPointReadOnly by Mozilla Contributors is licensed under CC-BY-SA 2.5.