requireNonArray

function requireNonArray<T>(
  value: T | unknown[],
  message: string = "Expected a non-array value."
): T;

Die Prüfung ist genau Array.isArray: ein Array aus einem anderen Frame zählt, ein array-ähnliches Objekt — arguments, eine NodeList, { length: 0 } — 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 \\| unknown[]`	Der zu validierende Wert.
`message` (optional) `= "Expected a non-array 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 Array ist.

Ausnahmen

Ausnahme	Bedingung
`IllegalArgumentException`	der Wert ist ein Array.

Beispiele

Was besteht und was nicht

requireNonArray("abc"); // => "abc"
requireNonArray({ length: 0 }); // => { length: 0 }
requireNonArray([]); // throws IllegalArgumentException
requireNonArray([1, 2, 3]); // throws IllegalArgumentException

Siehe auch

Quellcode

src/lang/base/requireNonArray.ts

23 September 2026

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