Web/JavaScript/Reference/Global objects/Math/asin
The Math.asin() function returns the arcsine (in radians) of a number, that is
<math display="block">\forall x \in \lbrack{- 1};1\rbrack,\;\mathtt{\operatorname{Math.asin}(x)} = \arcsin(x) = \text{the\ unique}\; y \in \left\lbrack {- \frac{\pi}{2};\frac{\pi}{2}} \right\rbrack\,\text{such\ that}\;\sin(y) = x</math>
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax
Math.asin(x)
Parameters
x- A number.
Return value
The arcsine (in radians) of the given number if it's between -1 and 1; otherwise, NaN.
Description
The Math.asin() method returns a numeric value between <math display="inline">- \frac{\pi}{2}</math> and <math display="inline">\frac{\pi}{2}</math> radians for x between -1 and 1. If the value of x is outside this range, it returns NaN.
Because asin() is a static method of Math, you always use it as Math.asin(), rather than as a method of a Math object you created (Math is not a constructor).
Examples
Using Math.asin()
Math.asin(-2); // NaN
Math.asin(-1); // -1.5707963267948966 (-pi/2)
Math.asin(0); // 0
Math.asin(0.5); // 0.5235987755982989
Math.asin(1); // 1.5707963267948966 (pi/2)
Math.asin(2); // NaN
For values less than -1 or greater than 1, Math.asin() returns NaN.
Specifications
| Specification |
|---|
| ECMAScript (ECMA-262)The definition of 'Math.asin' in that specification. |
Browser compatibility
The compatibility table in 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 | Server | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
asin
|
Chrome
Full support 1 |
Edge
Full support 12 |
Firefox
Full support 1 |
IE
Full support 3 |
Opera
Full support 3 |
Safari
Full support 1 |
WebView Android
Full support 1 |
Chrome Android
Full support 18 |
Firefox Android
Full support 4 |
Opera Android
Full support 10.1 |
Safari iOS
Full support 1 |
Samsung Internet Android
Full support 1.0 |
nodejs
Full support 0.1.100 |
Legend
- Full support
- Full support
See also
Math.asin() by Mozilla Contributors is licensed under CC-BY-SA 2.5.