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

function checkNumber(smallNumber) {
  if (smallNumber === Number.NEGATIVE_INFINITY) {
    return "Process number as -Infinity";
  }
  return smallNumber;
}

console.log(checkNumber(-Number.MAX_VALUE));
// Expected output: -1.7976931348623157e+308

console.log(checkNumber(-Number.MAX_VALUE * 2));
// Expected output: "Process number as -Infinity"
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® 2025 Language Specification
# sec-number.negative_infinity

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
NEGATIVE_INFINITY

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Veja também