--- title: Math.asin() slug: Web/JavaScript/Reference/Global_Objects/Math/asin tags: - JavaScript - Math - Method - Reference translation_of: Web/JavaScript/Reference/Global_Objects/Math/asin ---
{{JSRef("Global_Objects", "Math")}}

Сводка

Метод Math.asin() возвращает арксинус числа (в радианах), то есть

x[-1;1],Math.asin(x)=arcsin(x)= уникальный y[-π2;π2]такой, чтоsin(y)=x\forall x \in [{-1};1],\;\mathtt{\operatorname{Math.asin}(x)} = \arcsin(x) = \text{ уникальный } \; y \in \left[-\frac{\pi}{2}; \frac{\pi}{2}\right] \, \text{такой, что} \; \sin(y) = x

Синтаксис

Math.asin(x)

Параметры

x
Число.

Описание

Метод Math.asin() возвращает числовое значение между -π2-\frac{\pi}{2} и π2\frac{\pi}{2} радианами для значения x, лежащего в диапазоне от -1 до 1. Метод вернёт {{jsxref("NaN")}}, если значение x выйдет за этот диапазон.

Поскольку метод asin() является статическим методом объекта Math, вы всегда должны использовать его как Math.asin(), а не пытаться вызывать метод на созданном экземпляре объекта Math (поскольку объект Math не является конструктором).

Примеры

Пример: использование метода 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.570796326794897 (pi/2)
Math.asin(2);   // NaN

Для значений, меньших -1 или больших 1, метод Math.asin() возвращает {{jsxref("NaN")}}.

Спецификации

Спецификация Статус Комментарии
ECMAScript 1-е издание. Стандарт Изначальное определение. Реализована в 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')}}  

Совместимость с браузерами

{{CompatibilityTable}}
Возможность Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базовая поддержка {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}}
Возможность Android Chrome для Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базовая поддержка {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}}

Смотрите также