nonArray

function nonArray<T>(value: T | unknown): value is Exclude<T | unknown, unknown[] | Array<unknown>>;

nonArray(value) ist dieselbe Prüfung wie !isArray(value), so geschrieben, dass eine Wächterklausel sich wie ein Satz liest und nicht wie eine Verneinung.

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 prüfende Wert.

Rückgabewert

boolean — true, wenn der Wert nicht ein Array ist; sonst false.

In TypeScript verengt die Prüfung value innerhalb des Zweigs auf Exclude<T | unknown, unknown[] | Array<unknown>>.

Beispiele

Was besteht und was nicht

nonArray("abc"); // => true
nonArray({ length: 0 }); // => true
nonArray(null); // => true
nonArray([]); // => false
nonArray([1, 2, 3]); // => false

Siehe auch

Quellcode

src/lang/base/nonArray.ts

23 September 2026

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