Number.isSafeInteger()

Die Number.isSafeInteger() Methode prüft, ob der übergebene Wert eine Nummer ist, die ein sichere ganze Zahl ist.

Eine sichere ganze Zahl ist

  • eine Zahl, die exakt als IEEE-754 double precision Zahl repräsentiert werden kann, und
  • eine Zahl, deren IEEE-754 Repräsentation nicht das Ergebnis von Rundungen anderer ganzer Zahlen sein kann.

Zum Beispiel ist 253 - 1 eine sichere ganze Zahle: sie kann exakt repräsentiert werden und keine andere ganze Zahl wird in jedem IEEE-754 Rundungsmodus zu ihr gerundet. Im gegensatz dazu ist 253 keine sichere ganze Zahl: Sie kann in IEEE-754 exakt repräsentiert werden, jedoch wird die ganze Zahl 253 + 1 kann nicht exakt repräsentiert werden und wird zu 253 in den Modus zum nächsten Runden und zu null runden gerundet. Die sicheren ganzen Zahlen sind alle ganzen Zahlen im Bereich von -(253 - 1) inklusiv und 253 - 1 inklusiv.

Der Einsatz von Zahlen größer ~9 Biliarden oder kleiner ~-9 Biliarder mit voller Präzision benötigen eine Langzahlarythmetik Bibliothek. Mehr Informationen über die Repräsentation von Gleitkommazahlen gibt es in dem Artikel What Every Programmer Needs to Know about Floating Point Arithmetic.

Syntax

Number.isSafeInteger(testValue)

Parameter

testValue
Wert der getestet wird, ob er ein sichere ganze Zahl ist.

Rückgabewert

Ein Boolean, der angibt, ob die übergebenen Zahl eine sichere ganze Zahl ist oder nicht.

Beispiele

Number.isSafeInteger(3);                    // true
Number.isSafeInteger(Math.pow(2, 53));      // false
Number.isSafeInteger(Math.pow(2, 53) - 1);  // true
Number.isSafeInteger(NaN);                  // false
Number.isSafeInteger(Infinity);             // false
Number.isSafeInteger('3');                  // false
Number.isSafeInteger(3.1);                  // false
Number.isSafeInteger(3.0);                  // true

Polyfill

Number.isSafeInteger = Number.isSafeInteger || function (value) {
   return Number.isInteger(value) && Math.abs(value) <= Number.MAX_SAFE_INTEGER;
};

Spezifikationen

Spezifikation Status Kommentar
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'Number.isSafeInteger' in dieser Spezifikation.		 Standard Initiale Definition.
ECMAScript Latest Draft (ECMA-262)
Die Definition von 'Number.isSafeInteger' in dieser Spezifikation.		 Entwurf  

Browserkompatibilität

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung InternetNode.js
isSafeIntegerChrome Vollständige Unterstützung 34Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 32IE Keine Unterstützung NeinOpera Vollständige Unterstützung 21Safari Vollständige Unterstützung 10WebView Android Vollständige Unterstützung ≤37Chrome Android Vollständige Unterstützung 34Firefox Android Vollständige Unterstützung 32Opera Android Vollständige Unterstützung 21Safari iOS Vollständige Unterstützung JaSamsung Internet Android Vollständige Unterstützung 2.0nodejs Vollständige Unterstützung 0.12

Legende

Vollständige Unterstützung  
Vollständige Unterstützung
Keine Unterstützung  
Keine Unterstützung

Siehe auch

Verwandte Themen
  1. Standard-Objekte
  2. Number
  3. Eigenschaften
    1. Number.EPSILON
    2. Number.MAX_SAFE_INTEGER
    3. Number.MAX_VALUE
    4. Number.MIN_SAFE_INTEGER
    5. Number.MIN_VALUE
    6. Number.NEGATIVE_INFINITY
    7. Number.NaN
    8. Number.POSITIVE_INFINITY
    9. Number.prototype
  4. Methoden
    1. Number.isFinite()
    2. Number.isInteger()
    3. Number.isNaN()
    4. Number.isSafeInteger()
    5. Number.parseFloat()
    6. Number.parseInt()
    7. Number.prototype.toExponential()
    8. Number.prototype.toFixed()
    9. Number.prototype.toLocaleString()
    10. Number.prototype.toPrecision()
    11. Number.prototype.toSource()
    12. Number.prototype.toString()
    13. Number.prototype.valueOf()
    14. Number.toInteger()
  5. Vererbung:
  6. Function
  7. Eigenschaften
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.name
    7. Function.prototype
  8. Methoden
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  9. Object
  10. Eigenschaften
    1. Object.prototype.__count__ [Übersetzen]
    2. Object.prototype.__noSuchMethod__ [Übersetzen]
    3. Object.prototype.__parent__ [Übersetzen]
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  11. Methoden
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__() [Übersetzen]
    3. Object.prototype.__lookupGetter__() [Übersetzen]
    4. Object.prototype.__lookupSetter__() [Übersetzen]
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf() [Übersetzen]
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString() [Übersetzen]
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch() [Übersetzen]
    12. Object.prototype.valueOf()
    13. Object.prototype.watch() [Übersetzen]
    14. Object.setPrototypeOf() [Übersetzen]