requireConsistent2DArray

function requireConsistent2DArray<T>(value: unknown, message?: string): T[][];

Суворий варіант require2DArray: значення має бути непорожнім масивом масивів і кожен рядок має бути такої самої ширини, як перший.

Коли рядки різняться, типове повідомлення називає проблемний рядок і обидві ширини — те, що потрібно для виправлення виклику, і саме те, про що Range#setValues мовчить, відхиляючи нерівну матрицю. Власне повідомлення заміняє типове в обох випадках відмови.

Параметри

Параметр	Тип	Опис
`value`	`unknown`	Значення, що перевіряється.
`message` (необов'язковий)	`string`	Повідомлення винятку. Якщо не задано, використовується типове, що описує розбіжність.

Повертає

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

Винятки

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

Приклади

Матриця, яку безпечно записувати

/**
 * Accepts only a matrix whose rows are all the same width. The default message
 * names the offending row and both widths.
 */
export function writeMatrix(sheet: GoogleAppsScript.Spreadsheet.Sheet, values: unknown): void {
  const rows = requireConsistent2DArray<string>(values);

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

function writeMatrix(sheet, values) {
  const rows = requireConsistent2DArray(values);
  sheet.getRange(1, 1, rows.length, rows[0].length).setValues(rows);
}

Повідомлення називає проблемний рядок

requireConsistent2DArray([
  [1, 2],
  [3, 4]
]); // => [[1, 2], [3, 4]]

requireConsistent2DArray([[1, 2], [3]]);
// throws IllegalArgumentException:
// Expected every row to have 2 columns, but row 1 has 1.

requireConsistent2DArray([1, 2], "rows must be a matrix");
// throws IllegalArgumentException: rows must be a matrix

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

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

Вихідний код

src/lang/array/requireConsistent2DArray.ts

23 September 2026

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