Math.acos()

Baseline Widely available

This feature is well established and works across many devices and browser versions. Itโ€™s been available across browsers since July 2015.

The Math.acos() static method returns the inverse cosine (in radians) of a number. That is,

โˆ€xโˆŠ[โˆ’1,1],๐™ผ๐šŠ๐š๐š‘.๐šŠ๐šŒ๐š˜๐šœ(๐šก)=arccos(x)=the unique yโˆŠ[0,ฯ€] such that cos(y)=x\forall x \in [{-1}, 1],\;\mathtt{\operatorname{Math.acos}(x)} = \arccos(x) = \text{the unique } y \in [0, \pi] \text{ such that } \cos(y) = x

Try it

// Calculates angle of a right-angle triangle in radians
function calcAngle(adjacent, hypotenuse) {
  return Math.acos(adjacent / hypotenuse);
}

console.log(calcAngle(8, 10));
// Expected output: 0.6435011087932843

console.log(calcAngle(5, 3));
// Expected output: NaN

Syntax

Math.acos(x)

Parameters

x

A number between -1 and 1, inclusive, representing the angle's cosine value.

Return value

The inverse cosine (angle in radians between 0 and ฯ€, inclusive) of x. If x is less than -1 or greater than 1, returns NaN.

Description

Because acos() is a static method of Math, you always use it as Math.acos(), rather than as a method of a Math object you created (Math is not a constructor).

Examples

Using Math.acos()

Math.acos(-2); // NaN
Math.acos(-1); // 3.141592653589793 (ฯ€)
Math.acos(0); // 1.5707963267948966 (ฯ€/2)
Math.acos(0.5); // 1.0471975511965979 (ฯ€/3)
Math.acos(1); // 0
Math.acos(2); // NaN

Specifications

Browser compatibility

Desktop Mobile Server
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android Deno Node.js
acos 1 12 1 3 1 18 4 10.1 1 1.0 4.4 1.0 0.10.0

See also

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/acos