--- title: Math.atanh() slug: Web/JavaScript/Reference/Global_Objects/Math/atanh tags: - JavaScript - Math - Method - Reference - Referencia - metodo translation_of: Web/JavaScript/Reference/Global_Objects/Math/atanh ---
{{JSRef}}

A função Math.atanh() retorna o arco tangente hiperbólico de um número, onde

x(-1,1),Math.atanh(x)=arctanh(x)= the unique ysuch thattanh(y)=x\forall x \in \left( -1, 1 \right), \mathtt{\operatorname{Math.atanh}(x)} = \operatorname{arctanh}(x) = \text{ the unique } \; y \; \text{such that} \; \tanh(y) = x

Sintaxe

Math.atanh(x)

Parâmetros

x
O número.

Valor retornado

O arco tangente hiperbólico do parâmetro recebido.

Descrição

Por atanh() ser um método estático de Math, deve-se sempre usá-lo como Math.atanh(), e não como um método de um objeto Math que você criou.

Exemplos

Usando Math.atanh()

Math.atanh(-2);  // NaN
Math.atanh(-1);  // -Infinity
Math.atanh(0);   // 0
Math.atanh(0.5); // 0.5493061443340548
Math.atanh(1);   // Infinity
Math.atanh(2);   // NaN

For values greater than 1 or less than -1, {{jsxref("NaN")}} is returned.

Para valores menores que -1 ou maiores que 1, {{jsxref("NaN")}} é retornado.

Polyfill

Para |x|<1\left|x\right| < 1, temos artanh(x)=12ln(1+x1-x)\operatorname {artanh} (x) = \frac{1}{2}\ln \left( \frac{1 + x}{1 - x} \right), esse comportamento pode ser emulado com a seguinte função:

Math.atanh = Math.atanh || function(x) {
  return Math.log((1+x)/(1-x)) / 2;
};

Especificações

Specification Status Comment
{{SpecName('ES6', '#sec-math.atanh', 'Math.atanh')}} {{Spec2('ES6')}} Definição inicial.
{{SpecName('ESDraft', '#sec-math.atanh', 'Math.atanh')}} {{Spec2('ESDraft')}}  

Compatibilidade no navegadores

{{Compat("javascript.builtins.Math.atanh")}}

Veja também