--- title: Math.asin() slug: Web/JavaScript/Reference/Global_Objects/Math/asin tags: - JavaScript - Math - Méthode - Reference translation_of: Web/JavaScript/Reference/Global_Objects/Math/asin original_slug: Web/JavaScript/Reference/Objets_globaux/Math/asin --- {{JSRef}} 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 {{EmbedInteractiveExample("pages/js/math-asin.html")}} ## Syntaxe 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 {{jsxref("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 {{jsxref("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 {{jsxref("NaN")}}. ## Spécifications | Spécification | Statut | Commentaires | | ------------------------------------------------------------------------ | ---------------------------- | ----------------------------------------------------- | | {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. Implémentée avec JavaScript 1.0. | | {{SpecName('ES5.1', '#sec-15.8.2.3', 'Math.asin')}} | {{Spec2('ES5.1')}} |   | | {{SpecName('ES6', '#sec-math.asin', 'Math.asin')}} | {{Spec2('ES6')}} |   | | {{SpecName('ESDraft', '#sec-math.asin', 'Math.asin')}} | {{Spec2('ESDraft')}} |   | ## Compatibilité des navigateurs {{Compat("javascript.builtins.Math.asin")}} ## Voir aussi - {{jsxref("Math.acos()")}} - {{jsxref("Math.atan()")}} - {{jsxref("Math.atan2()")}} - {{jsxref("Math.cos()")}} - {{jsxref("Math.sin()")}} - {{jsxref("Math.tan()")}}