requireSafeInteger

function requireSafeInteger(value: unknown, message: string = "Expected a safe integer."): number;

Eine ganze Zahl, die ein IEEE-754-Double exakt darstellt. Jenseits dieses Bereichs fallen verschiedene mathematische Ganzzahlen auf denselben Wert und das Rechnen ist still nicht mehr exakt.

isX und nonX beantworten eine Frage und unterbrechen den Ablauf nie; requireX und requireNonX geben den Wert zurück oder werfen. Das Schema erklärt Konventionen der Prüfungen.

Parameter

Parameter	Typ	Beschreibung
`value`	`unknown`	Der zu validierende Wert.
`message` (optional) `= "Expected a safe integer."`	`string`	Die Meldung der Ausnahme. Ohne Angabe wird eine Standardmeldung verwendet.

Rückgabewert

number — denselben Wert, typisiert als eine sichere ganze Zahl.

Ausnahmen

Ausnahme	Bedingung
`IllegalArgumentException`	der Wert ist nicht eine sichere ganze Zahl.

Beispiele

Was besteht und was nicht

requireSafeInteger(42); // => 42
requireSafeInteger(Number.MAX_SAFE_INTEGER); // => Number.MAX_SAFE_INTEGER
requireSafeInteger(Number.MAX_SAFE_INTEGER + 2); // throws IllegalArgumentException
requireSafeInteger(1.5); // throws IllegalArgumentException

Siehe auch

Quellcode

src/lang/number/requireSafeInteger.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.