is2DArray

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

Це форма, яку повертає Range#getValues і яку очікує Range#setValues: рядки, складені з комірок. is2DArray відповідає лише на питання про форму — чи однакової довжини рядки, перевіряє isConsistent2DArray.

Порожній масив тут не вважається двовимірним: рядків для перевірки немає, а якщо вважати [] матрицею, порожній результат непомітно дійде до setValues і там впаде. Більше нічого про елементи не перевіряється, тож матриця зі значень різних типів проходить.

Параметри

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

Повертає

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

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

Приклади

Що вважається двовимірним масивом

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

Захист значення, яке може виявитися матрицею

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

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

isConsistent2DArray — додає перевірку однакової довжини рядків.
non2DArray — та сама перевірка із запереченням.
require2DArray — замість відповіді викидає виняток.
Базові утиліти

Вихідний код

src/lang/array/is2DArray.ts

23 September 2026

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