is2DArray

function is2DArray(arr: unknown): arr is Array<Array<unknown>>;

Das ist die Form, die Range#getValues zurückgibt und die Range#setValues erwartet: Zeilen aus Zellen. is2DArray beantwortet nur die Frage nach der Form — ob alle Zeilen gleich lang sind, prüft isConsistent2DArray.

Ein leeres Array gilt hier nicht als zweidimensional: es gibt keine Zeilen zu prüfen, und [] als Matrix durchzulassen ist genau das, was ein leeres Ergebnis unbemerkt in einen setValues-Aufruf rutschen lässt. Über die Elemente selbst wird nichts weiter geprüft, eine Matrix gemischter Typen besteht die Prüfung.

Parameter

Parameter	Typ	Beschreibung
`arr`	`unknown`	Der zu prüfende Wert.

Rückgabewert

boolean — true, wenn der Wert ein nicht-leeres Array ist und jedes Element davon ein Array ist; sonst false.

In TypeScript verengt die Prüfung arr innerhalb des Zweigs auf Array<Array<unknown>>.

Beispiele

Was als zweidimensional gilt

is2DArray([[1, 2], [3]]); // => true — ragged, but still 2D
is2DArray([[1], 2]); // => false — one element is not an array
is2DArray([]); // => false — no rows
is2DArray("abc"); // => false

Einen Wert absichern, der eine Matrix sein könnte

/**
 * Counts the cells of a value that may or may not be a matrix. Inside the
 * guard the value is narrowed to `Array<Array<unknown>>`.
 */
export function countCells(value: unknown): number {
  if (!is2DArray(value)) {
    return 0;
  }

  return value.reduce((total: number, row: unknown[]): number => total + row.length, 0);
}

function countCells(value) {
  if (!is2DArray(value)) {
    return 0;
  }
  return value.reduce((total, row) => total + row.length, 0);
}

Siehe auch

isConsistent2DArray — ergänzt die Prüfung auf gleiche Zeilenlänge.
non2DArray — dieselbe Prüfung, verneint.
require2DArray — wirft eine Ausnahme statt zu antworten.
Basis-Werkzeuge

Quellcode

src/lang/array/is2DArray.ts

23 September 2026

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