non2DArray

function non2DArray<T>(arr: T | Array<Array<unknown>>): arr is T;

non2DArray(value) — та сама перевірка, що й !is2DArray(value). Префікс існує заради того, щоб охоронна умова читалася як твердження, а не як заперечення — дивіться Домовленості про перевірки.

Порожній масив вважається «не двовимірним», бо is2DArray вимагає щонайменше одного рядка.

Застереження про типи: страж оголошено як type predicate, але звуження працює лише тоді, коли в типі самого значення вже присутній випадок unknown[][]. У гілці, де значення все ж є матрицею, TypeScript лишає never, а не тип матриці, тож для подальшої роботи з матрицею беріть is2DArray або require2DArray. Як логічна відповідь non2DArray точний завжди.

Параметри

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

Повертає

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

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

Приклади

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

non2DArray([1, 2]); // => true — flat
non2DArray([]); // => true — no rows
non2DArray("abc"); // => true
non2DArray([[1], [2]]); // => false

Повідомлення про причину відмови

/**
 * Validates the shape of a value before it reaches `setValues`, and returns
 * the reason it was rejected rather than throwing.
 */
export function validateShape(rows: unknown): string | null {
  if (non2DArray(rows)) {
    return "Expected a matrix: a non-empty array of rows.";
  }

  if (nonConsistent2DArray(rows)) {
    return "Every row must have the same number of columns.";
  }

  return null;
}

function validateShape(rows) {
  if (non2DArray(rows)) {
    return "Expected a matrix: a non-empty array of rows.";
  }
  if (nonConsistent2DArray(rows)) {
    return "Every row must have the same number of columns.";
  }
  return null;
}

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

is2DArray — позитивна форма.
nonConsistent2DArray — відхиляє ще й нерівну матрицю.
require2DArray — замість відповіді викидає виняток.
Базові утиліти

Вихідний код

src/lang/array/non2DArray.ts

23 September 2026

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