The Number.NEGATIVE_INFINITY property represents the negative Infinity value.
You do not have to create a Number object to access this static property (use Number.NEGATIVE_INFINITY).
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. - 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.- Any number divided by
NEGATIVE_INFINITYis negative zero.
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.
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 | Status | Comment |
|---|---|---|
| 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 | |
| ECMAScript Latest Draft (ECMA-262) The definition of 'Number.NEGATIVE_INFINITY' in that specification. |
Draft |
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.
| Feature | Chrome | Firefox | Edge | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic Support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
| Feature | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
|---|---|---|---|---|---|---|---|
| Basic Support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |