isConsistent2DArray

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

Das ist die Prüfung vor Range#setValues, das eine ungleichmäßige Matrix mit einer Meldung ablehnt, die weder die betroffene Zeile noch den Grund nennt. Alles, was is2DArray verlangt, gilt auch hier — ein nicht-leeres Array aus Arrays — zuzüglich der Regel, dass jede Zeile so breit ist wie die erste.

Parameter

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

Rückgabewert

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

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

Beispiele

Gleichmäßige Zeilen, ungleiche Zeilen und Nicht-Matrizen

isConsistent2DArray([
  [1, 2],
  [3, 4]
]); // => true
isConsistent2DArray([[1, 2], [3]]); // => false — rows differ in length
isConsistent2DArray([1, 2]); // => false — not 2D at all
isConsistent2DArray([]); // => false

Vor dem Schreiben in einen Bereich

/**
 * Writes a matrix to a sheet, refusing a ragged one with a message that says
 * what is wrong — which `setValues` itself does not.
 */
export function write(sheet: GoogleAppsScript.Spreadsheet.Sheet, rows: unknown): void {
  if (!isConsistent2DArray(rows)) {
    throw new Error("Every row must have the same number of columns.");
  }

  sheet.getRange(1, 1, rows.length, rows[0].length).setValues(rows);
}

function write(sheet, rows) {
  if (!isConsistent2DArray(rows)) {
    throw new Error("Every row must have the same number of columns.");
  }
  sheet.getRange(1, 1, rows.length, rows[0].length).setValues(rows);
}

Siehe auch

is2DArray — die Formprüfung ohne die Regel zur Zeilenlänge.
nonConsistent2DArray — dieselbe Prüfung, verneint.
requireConsistent2DArray — wirft und benennt die betroffene Zeile.
Basis-Werkzeuge

Quellcode

src/lang/array/isConsistent2DArray.ts

23 September 2026

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