Web/API/DOMPointInit/y

The DOMPointInit dictionary's y property is used to specify the y-coordinate of a point in 2D or 3D space when either creating or serializing to JSON a DOMPoint or DOMPointReadOnly object.

In general, the value of y increases to the right and decreases to the left, becoming negative to the left of the origin. This may change if transforms have been applied causing the axes' orientation to change.

Syntax

var DOMPointInit = {
  y: yPos
};

DOMPointInit.y = yPos;

var yPos = DOMPointInit.y;

Value

A double-precision floating-point value indicating the point's y-coordinate. This value is unrestricted, meaning that it is allowed to be infinite or invalid (that is, its value may be NaN or ±Infinity).

If this property is missing when the DOMPointInit object is passed into fromPoint(), the value is assumed to be 0 by default.

There are two methods which use DOMPointInit:

• The static function DOMPointReadOnly.fromPoint() takes an object that complies with DOMPointInit as its sole input parameter, to specify the coordinates and perspective value of the new point to be created. This method is, by inheritance, also available as DOMPoint.fromPoint().
• The DOMPointReadOnly.toJSON() method returns a DOMPointInit object that describes the same point as the original point. By inheritance, this method is also available as DOMPoint.toJSON().

Specifications

Specification	Status	Comment
Geometry Interfaces Module Level 1The definition of 'y' in that specification.	Candidate Recommendation	Initial definition

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
y Experimental'	Chrome ?	Edge ?	Firefox Full support 62	IE No support No	Opera ?	Safari No support No	WebView Android ?	Chrome Android ?	Firefox Android Full support 62	Opera Android ?	Safari iOS No support No	Samsung Internet Android ?

Legend

Full support  

Full support

No support  

No support

Compatibility unknown  

Compatibility unknown

Experimental. Expect behavior to change in the future.'

Experimental. Expect behavior to change in the future.

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