Name

Math.atan2() — compute the angle from the X axis to a point

Synopsis

Math.atan2(y, x)

Arguments

y

The Y coordinate of the point.

x

The X coordinate of the point.

Returns

A value between -π and π radians that specifies the counterclockwise angle between the positive X axis and the point (x, y).

Description

The Math.atan2() function computes the arc tangent of the ratio y/x. The y argument can be considered the Y coordinate (or “rise”) of a point, and the x argument can be considered the X coordinate (or “run”) of the point. Note the unusual order of the arguments to this function: the Y coordinate is passed before the X coordinate.

Get JavaScript: The Definitive Guide, 6th Edition now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.