require2DArray

function require2DArray<T>(
  value: unknown,
  message: string = "Expected a non-empty two-dimensional array."
): T[][];

Перевірка, яку ставлять перед Range#setValues: той відхиляє плоский масив повідомленням, що не називає ні аргумента, ні причини. require2DArray викидає виняток раніше, з вашим повідомленням, і повертає значення, тож виклик вбудовується у вираз.

Приймається рівно те саме, що приймає is2DArray: непорожній масив, кожен елемент якого — масив. Рядки різної довжини проходять; коли вони мають збігатися, беріть requireConsistent2DArray.

Параметри

Параметр	Тип	Опис
`value`	`unknown`	Значення, що перевіряється.
`message` (необов'язковий) `= "Expected a non-empty two-dimensional array."`	`string`	Повідомлення винятку. Типово `"Expected a non-empty two-dimensional array."`

Повертає

T[][] — те саме значення з типом двовимірного масиву.

Винятки

Виняток	Умова
`IllegalArgumentException`	значення не є непорожнім масивом масивів.

Приклади

Перевірка та використання в одному виразі

/**
 * Validates the argument at the boundary of the function, with a message that
 * names the argument, and uses the validated value in the same expression.
 */
export function writeRows(sheet: GoogleAppsScript.Spreadsheet.Sheet, values: unknown): void {
  const rows = require2DArray<string>(values, "values must be a matrix of rows");

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

function writeRows(sheet, values) {
  const rows = require2DArray(values, "values must be a matrix of rows");
  sheet.getRange(1, 1, rows.length, rows[0].length).setValues(rows);
}

Що проходить, а що ні

require2DArray([
  [1, 2],
  [3, 4]
]); // => [[1, 2], [3, 4]]
require2DArray([1, 2]); // throws IllegalArgumentException
require2DArray([]); // throws IllegalArgumentException — no rows

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

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

Вихідний код

src/lang/array/require2DArray.ts

23 September 2026

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