isConsistent2DArray

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

Цю перевірку варто робити перед Range#setValues, який відхиляє нерівну матрицю повідомленням, що не називає ні проблемного рядка, ні причини. Усе, чого вимагає is2DArray, має виконуватися й тут — непорожній масив масивів, — плюс правило, що кожен рядок такої самої ширини, як перший.

Параметри

Параметр	Тип	Опис
`arr`	`unknown`	Значення, що перевіряється.

Повертає

boolean — true, якщо значення — непорожній масив масивів однакової довжини; інакше false.

У TypeScript усередині гілки значення arr звужується до Array<Array<unknown>>.

Приклади

Рівні рядки, нерівні рядки та не-матриці

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

Перед записом у діапазон

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

Дивіться також

is2DArray — перевірка форми без правила про довжину рядків.
nonConsistent2DArray — та сама перевірка із запереченням.
requireConsistent2DArray — викидає виняток і називає проблемний рядок.
Базові утиліти

Вихідний код

src/lang/array/isConsistent2DArray.ts

23 September 2026

Цю документацію згенеровано нейромережею (Claude) на основі вихідного коду бібліотеки.