Number.NEGATIVE_INFINITY

A propriedade Number.NEGATIVE_INFINITY representa o valor negativo Infinito.

Não tem de criar um objecto Number para aceder a esta propriedade estática (usa Number.NEGATIVE_INFINITY).

Property attributes of Number.NEGATIVE_INFINITY
Writable no
Enumerable no
Configurable no

Descrição

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

Este valor comporta-se de forma ligeiramente diferente do infinito matemático:

  • Qualquer valor positivo, incluindo POSITIVE_INFINITY (en-US), multiplicado por NEGATIVE_INFINITY é igual a NEGATIVE_INFINITY.
  • Qualquer valor negativo, incluindo,NEGATIVE_INFINITY multiplicado por NEGATIVE_INFINITY é igual a POSITIVE_INFINITY (en-US).
  • O valor 0 (zero) multiplicado por NEGATIVE_INFINITY é igual a NaN.
  • NaN multiplicado por NEGATIVE_INFINITY é igual a NaN.
  • NEGATIVE_INFINITY, dividido por qualquer valor negativo excepto NEGATIVE_INFINITY, é igual a POSITIVE_INFINITY (en-US).
  • NEGATIVE_INFINITY, dividido por qualquer valor positivo exceto POSITIVE_INFINITY (en-US), é igual a NEGATIVE_INFINITY.
  • NEGATIVE_INFINITY, dividido por outro NEGATIVE_INFINITY ou POSITIVE_INFINITY (en-US), é igual a NaN.
  • Qualquer número dividido por NEGATIVE_INFINITY é igual a 0 (zero).

Pode usar a propriedade Number.NEGATIVE_INFINITY para indicar uma condição de erro numa situação em que, no caso de sucesso, é retornado um valor finito.

Exemplos

Usando NEGATIVE_INFINITY

No seguinte exemplo, é atribuído à variável smallNumber um valor inferior ao valor mínimo. Quando a linha de código if (en-US) é executada, a variável smallNumber tem o valor -Infinity, então é atribuída à mesma variável um valor finito antes de continuar.

var smallNumber = (-Number.MAX_VALUE) * 2;

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

Especificações

Especificação Estado Comentário
ECMAScript 1st Edition (ECMA-262) Standard Initial definition. Implemented in JavaScript 1.1.
ECMAScript 5.1 (ECMA-262)
The definition of 'Number.NEGATIVE_INFINITY' in that specification.
Standard
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Number.NEGATIVE_INFINITY' in that specification.
Standard

Compatibilidade

BCD tables only load in the browser

Ver também