isConsistent2DArray

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

C'est la vérification à faire avant Range#setValues, qui rejette une matrice irrégulière avec un message ne nommant ni la ligne fautive ni la raison. Tout ce qu'exige is2DArray vaut également ici — un tableau non vide de tableaux — plus la règle que chaque ligne est aussi large que la première.

Paramètres

Paramètre	Type	Description
`arr`	`unknown`	La valeur à vérifier.

Valeur de retour

boolean — true si la valeur est un tableau non vide de tableaux de même longueur ; sinon false.

En TypeScript, le garde restreint arr à Array<Array<unknown>> dans la branche.

Exemples

Lignes régulières, lignes irrégulières et non-matrices

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

Avant d'écrire dans une plage

/**
 * 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);
}

Voir aussi

is2DArray — le contrôle de forme sans la règle de longueur.
nonConsistent2DArray — la même vérification, niée.
requireConsistent2DArray — lève et nomme la ligne fautive.
Utilitaires de base

Code source

src/lang/array/isConsistent2DArray.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.