requireNonScalar

function requireNonScalar<T>(
  value: T | string | number | boolean | symbol | bigint,
  message: string = "Expected a non-scalar value."
): T;

Ein Primitivwert, der genau einen Wert trägt: String, Zahl, Boolean, Symbol oder BigInt. null und undefined sind ebenfalls primitiv, tragen aber keinen Wert und zählen nicht.

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`	`T \\| string \\| number \\| boolean \\| symbol \\| bigint`	Der zu validierende Wert.
`message` (optional) `= "Expected a non-scalar value."`	`string`	Die Meldung der Ausnahme. Ohne Angabe wird eine Standardmeldung verwendet.

Rückgabewert

T — denselben Wert; nach der Prüfung steht fest, dass er nicht ein Skalar ist.

Ausnahmen

Ausnahme	Bedingung
`IllegalArgumentException`	der Wert ist ein Skalar.

Beispiele

Was besteht und was nicht

requireNonScalar({}); // => {}
requireNonScalar([]); // => []
requireNonScalar("abc"); // throws IllegalArgumentException
requireNonScalar(1); // throws IllegalArgumentException

Siehe auch

Quellcode

src/lang/base/requireNonScalar.ts

23 September 2026

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