Math.asin()

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.

La fonction Math.asin() renvoie l'arc sinus d'un nombre (en radians). Elle est définie par :

∀x∊[-1;1],Math.asin(x)=arcsin(x)= le seul y∊[-π2;π2]tel quesin(y)=x\forall x \in [{-1};1],;\mathtt{\operatorname{Math.asin}(x)} = \arcsin(x) = \text{ the unique } ; y \in \left[-\frac{\pi}{2}; \frac{\pi}{2}\right] , \text{such that} ; \sin(y) = x

Exemple interactif

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

console.log(calcAngle(6, 10));
// Expected output: 0.6435011087932844

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

Syntaxe

js
Math.asin(x);

Paramètres

x

Un nombre.

Valeur de retour

L'arc sinus du nombre passé en argument (exprimé en radians). Si ce nombre n'est pas compris entre -1 et 1, la valeur renvoyée sera NaN.

Description

La méthode Math.asin() renvoie une valeur numérique comprise entre -π2-\frac{\pi}{2} et π2\frac{\pi}{2} pour x compris entre -1 et 1. Si x est hors de cet intervalle, la méthode renverra NaN.

Math.asin() est une méthode statique de Math et doit toujours être utilisée avec la syntaxe Math.asin(), elle ne doit pas être appelée à partir d'un autre objet créé (Math n'est pas un constructeur).

Exemples

Utiliser Math.asin()

js
Math.asin(-2); // NaN
Math.asin(-1); // -1.570796326794897 (-pi/2)
Math.asin(0); // 0
Math.asin(0.5); // 0.5235987755982989
Math.asin(1); // 1.570796326794897 (pi/2)
Math.asin(2); // NaN

Pour les valeurs (strictement) inférieures à -1 ou supérieures à 1, Math.asin() renvoie NaN.

Spécifications

Specification
ECMAScript® 2025 Language Specification
# sec-math.asin

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi