The Number.NEGATIVE_INFINITY property represents the negative Infinity value.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
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
| Specification |
|---|
| ECMAScript (ECMA-262) The definition of 'Number.NEGATIVE_INFINITY' in that specification. |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Desktop | Mobile | Server | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NEGATIVE_INFINITY | Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1 | IE Full support 4 | Opera Full support 3 | Safari Full support 1 | WebView Android Full support 1 | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android Full support 10.1 | Safari iOS Full support 1 | Samsung Internet Android Full support 1.0 | nodejs Full support 0.1.100 |
Legend
- Full support
- Full support
