JavaScript Number.isSafeInteger()Methode

JavaScript Number-Objekt

Definition und Verwendung

Die Methode isSafeInteger() wird verwendet, um zu bestimmen, ob der übergebene Parameterwert eine "sichere Ganzzahl" ist. Wenn er eine sichere Ganzzahl ist, gibt sie true zurück; andernfalls gibt sie false zurück.

Eine sichere Ganzzahl ist eine Ganzzahl, die die folgenden Bedingungen erfüllt:

• Sie kann exakt als IEEE-754-Zahl mit doppelter Genauigkeit dargestellt werden.
• Ihre IEEE-754-Darstellung kann nicht das Ergebnis davon sein, dass eine andere Ganzzahl gerundet wird, um in die IEEE-754-Darstellung zu passen.

Zum Beispiel ist 2^53 - 1 eine sichere Ganzzahl. Sie kann exakt dargestellt werden, und unter jedem IEEE-754-Rundungsmodus wird keine andere Ganzzahl auf diese Ganzzahl gerundet. Im Gegensatz dazu ist 2^53 keine sichere Ganzzahl. Sie kann mit IEEE-754 dargestellt werden, aber 2^53 + 1 kann nicht direkt mit IEEE-754 dargestellt werden; bei Rundung auf den nächsten Wert und Rundung in Richtung null wird sie auf 2^53 gerundet.

Der Bereich sicherer Ganzzahlen umfasst Ganzzahlen zwischen -(2^53 - 1) und 2^53 - 1, einschließlich -(2^53 - 1) und 2^53 - 1.

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

Browser-Unterstützung

Number.isSafeInteger() ist ein neues Feature in ECMAScript 6 (ES6).

Im Grunde genommen unterstützen alle neuesten Browser-Versionen ES6 (JavaScript 2015).

Number.isSafeInteger() wird im Internet Explorer 11 und in früheren Browserversionen nicht unterstützt.

Syntax

Number.isSafeInteger(value)

Parameterwerte

Rückgabewert

Technische Details

Weitere Beispiele

JavaScript Number-Objekt