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.
The Number.NEGATIVE_INFINITY
static data property represents the negative Infinity value.
Try it
Value
The same as the negative value of the global Infinity
property.
Property attributes of Number.NEGATIVE_INFINITY | |
---|---|
Writable | no |
Enumerable | no |
Configurable | no |
Description
The Number.NEGATIVE_INFINITY
value behaves slightly differently than mathematical infinity:
- Any positive value, including
POSITIVE_INFINITY
, multiplied byNEGATIVE_INFINITY
isNEGATIVE_INFINITY
. - Any negative value, including
NEGATIVE_INFINITY
, multiplied byNEGATIVE_INFINITY
isPOSITIVE_INFINITY
. - Any positive value divided by
NEGATIVE_INFINITY
is negative zero (as defined in IEEE 754). - Any negative value divided by
NEGATIVE_INFINITY
is positive zero (as defined in IEEE 754). - Zero multiplied by
NEGATIVE_INFINITY
isNaN
. NaN
multiplied byNEGATIVE_INFINITY
isNaN
.NEGATIVE_INFINITY
, divided by any negative value exceptNEGATIVE_INFINITY
, isPOSITIVE_INFINITY
.NEGATIVE_INFINITY
, divided by any positive value exceptPOSITIVE_INFINITY
, isNEGATIVE_INFINITY
.NEGATIVE_INFINITY
, divided by eitherNEGATIVE_INFINITY
orPOSITIVE_INFINITY
, isNaN
.x > Number.NEGATIVE_INFINITY
is true for any number x that isn'tNEGATIVE_INFINITY
.
You might use the Number.NEGATIVE_INFINITY
property to indicate an error condition that returns a finite number in case of success. Note, however, that NaN
would be more appropriate in such a case.
Because NEGATIVE_INFINITY
is a static property of Number
, you always use it as Number.NEGATIVE_INFINITY
, rather than as a property of a number value.
Examples
Using NEGATIVE_INFINITY
In the following example, the variable smallNumber
is assigned a value that is smaller than the minimum value. When the if
statement executes, smallNumber
has the value -Infinity
, so smallNumber
is set to a more manageable value before continuing.
let smallNumber = -Number.MAX_VALUE * 2;
if (smallNumber === Number.NEGATIVE_INFINITY) {
smallNumber = returnFinite();
}
Specifications
Specification |
---|
ECMAScript Language Specification # sec-number.negative_infinity |
Browser compatibility
BCD tables only load in the browser