non2DArray

function non2DArray<T>(arr: T | Array<Array<unknown>>): arr is T;

non2DArray(value) ist dieselbe Prüfung wie !is2DArray(value). Das Präfix gibt es, damit eine Wächterklausel sich wie ein Satz liest und nicht wie eine Verneinung — siehe Konventionen der Prüfungen.

Ein leeres Array gilt als „nicht zweidimensional“, weil is2DArray mindestens eine Zeile verlangt.

Ein Vorbehalt zu den Typen: der Wächter ist als Typprädikat deklariert, verengt aber nur dann nützlich, wenn der Typ des Werts unknown[][] bereits als Fall enthält. In dem Zweig, in dem der Wert doch eine Matrix ist, bleibt TypeScript bei never statt bei einem Matrixtyp; greifen Sie dort zu is2DArray oder require2DArray. Als schlichte Ja-Nein-Antwort ist non2DArray immer exakt.

Parameter

Parameter	Typ	Beschreibung
`arr`	`T \\| Array<Array<unknown>>`	Der zu prüfende Wert.

Rückgabewert

boolean — true, wenn der Wert kein nicht-leeres Array aus Arrays ist; sonst false.

In TypeScript verengt die Prüfung arr innerhalb des Zweigs auf T.

Beispiele

Was als nicht zweidimensional gilt

non2DArray([1, 2]); // => true — flat
non2DArray([]); // => true — no rows
non2DArray("abc"); // => true
non2DArray([[1], [2]]); // => false

Melden, warum ein Wert abgelehnt wurde

/**
 * Validates the shape of a value before it reaches `setValues`, and returns
 * the reason it was rejected rather than throwing.
 */
export function validateShape(rows: unknown): string | null {
  if (non2DArray(rows)) {
    return "Expected a matrix: a non-empty array of rows.";
  }

  if (nonConsistent2DArray(rows)) {
    return "Every row must have the same number of columns.";
  }

  return null;
}

function validateShape(rows) {
  if (non2DArray(rows)) {
    return "Expected a matrix: a non-empty array of rows.";
  }
  if (nonConsistent2DArray(rows)) {
    return "Every row must have the same number of columns.";
  }
  return null;
}

Siehe auch

is2DArray — die positive Form.
nonConsistent2DArray — lehnt zusätzlich eine ungleichmäßige Matrix ab.
require2DArray — wirft eine Ausnahme statt zu antworten.
Basis-Werkzeuge

Quellcode

src/lang/array/non2DArray.ts

23 September 2026

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