Number.NEGATIVE_INFINITY
The Number.NEGATIVE_INFINITY property represents the negative Infinity value.
Property attributes of Number.NEGATIVE_INFINITY
| |
|---|---|
| Writable | no |
| Enumerable | no |
| Configurable | no |
Description
The value of Number.NEGATIVE_INFINITY is the same as the negative value of the global object's Infinity property.
This value behaves slightly differently than mathematical infinity:
- Any positive value, including
POSITIVE_INFINITY, multiplied byNEGATIVE_INFINITYisNEGATIVE_INFINITY. - Any negative value, including
NEGATIVE_INFINITY, multiplied byNEGATIVE_INFINITYisPOSITIVE_INFINITY. - Any positive value divided by
NEGATIVE_INFINITYis negative zero. - Any negative value divided by
NEGATIVE_INFINITYis positive zero. - Zero multiplied by
NEGATIVE_INFINITYisNaN. -
NaNmultiplied byNEGATIVE_INFINITYisNaN. -
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_INFINITYorPOSITIVE_INFINITY, isNaN.
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 isFinite 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 object you created.
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.
var smallNumber = (-Number.MAX_VALUE) * 2; if (smallNumber === Number.NEGATIVE_INFINITY) { smallNumber = returnFinite(); }
Specifications
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
NEGATIVE_INFINITY |
1 |
12 |
1 |
4 |
3 |
1 |
1 |
18 |
4 |
10.1 |
1 |
1.0 |
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/NEGATIVE_INFINITY