Number.NEGATIVE_INFINITY

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.

A propriedade Number.NEGATIVE_INFINITY representa o valor Infinito negativo.

Experimente

Property attributes of Number.NEGATIVE_INFINITY
Writableno
Enumerableno
Configurableno

Descrição

O valor de Number.NEGATIVE_INFINITY é o mesmo que o valor negativo da propriedade do objeto global Infinity.

O valor se comporta um pouco diferente do que o infinito matemático:

  • Qualquer valor positivo, incluindo POSITIVE_INFINITY, mutiplicado por NEGATIVE_INFINITY é NEGATIVE_INFINITY.
  • Qualquer valor negativo, incluindo NEGATIVE_INFINITY, multiplicado por NEGATIVE_INFINITY é POSITIVE_INFINITY.
  • Qualquer valor positivo dividido por NEGATIVE_INFINITY é zero negativo.
  • Qualquer valor negativo dividido por NEGATIVE_INFINITY é zero positivo.
  • Zero multiplicado por NEGATIVE_INFINITY é NaN.
  • NaN multiplicado por NEGATIVE_INFINITY é NaN.
  • NEGATIVE_INFINITY, dividido por qualquer valor negativo exceto NEGATIVE_INFINITY, é POSITIVE_INFINITY.
  • NEGATIVE_INFINITY, divido por qualquer valor positivo exceto POSITIVE_INFINITY, é NEGATIVE_INFINITY.
  • NEGATIVE_INFINITY, divido por ou NEGATIVE_INFINITY ou POSITIVE_INFINITY, é NaN.

Você pode usar a propriedade Number.NEGATIVE_INFINITY para indicar uma condição de erro que retorna um número finito em caso de sucesso. Nota que, usar isFinite seria mais apropriado neste caso.

Por NEGATIVE_INFINITY ser uma propriedade estática de Number, você sempre a usa como Number.NEGATIVE_INFINITY, ao invés de ser uma propriedade do objeto Number que você criou.

Exemplos

Usando NEGATIVE_INFINITY

No seguinte exemplo, a variável smallNumber é atribuída um valor que é menor que o valor mínimo. Quando o if executa, smallNumber tem o valor -Infinity, então é colocado em smallNumber um valor mais manejável antes de continuar.

js
var smallNumber = -Number.MAX_VALUE * 2;

if (smallNumber === Number.NEGATIVE_INFINITY) {
  smallNumber = returnFinite();
}

Especificações

Specification
ECMAScript Language Specification
# sec-number.negative_infinity

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também