last

function last<T>(array: T[]): T | undefined;
function last<T>(array: T[], n: number): T[];
function last<T>(array: T[], n?: number): T | T[] | undefined;

Це те, заради чого пишуть array[array.length - 1] — вираз, який на порожньому масиві дає undefined, вдаючи, що так і було задумано. last каже про це прямо і в тому самому випадку повертає undefined.

Форма з n бере елементи з кінця, але зберігає порядок: last([1, 2, 3], 2) — це [2, 3], а не [3, 2]. n обмежується: від'ємне значення дає порожній масив, більше за довжину — увесь масив. Вихідний масив не змінюється.

Параметри

Параметр	Тип	Опис
`array`	`T[]`	Масив, з якого читаємо. Не змінюється.
`n` (необов'язковий)	`number`	Скільки елементів узяти. Ціле число; пропустіть, щоб узяти один елемент.

Повертає

T | T[] | undefined — останній елемент або новий масив не більш ніж із n елементів у початковому порядку.

Винятки

Виняток	Умова
`TypeError`	`array` не є масивом.
`TypeError`	`n` передано і він не є цілим числом.

Приклади

Один елемент або кілька

last([1, 2, 3]); // => 3
last([]); // => undefined
last([1, 2, 3], 2); // => [2, 3] — order preserved

Читання останніх записів журналу

/**
 * Logs the ten newest entries of a log sheet, oldest of the ten first.
 */
export function logRecentEntries(sheet: GoogleAppsScript.Spreadsheet.Sheet): void {
  const rows = sheet.getDataRange().getValues().slice(1);

  for (const row of last(rows, 10)) {
    Logger.log(row.join(" | "));
  }
}

function logRecentEntries(sheet) {
  const rows = sheet.getDataRange().getValues().slice(1);
  for (const row of last(rows, 10)) {
    Logger.log(row.join(" | "));
  }
}

Обмеження кількості

last([1, 2], 10); // => [1, 2]
last([1, 2], -1); // => []
last([1, 2], 1.5); // throws TypeError: Input 'n' must be an integer.

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

first — ті самі дві форми, але з початку.
Базові утиліти

Вихідний код

src/lang/array/last.ts

23 September 2026

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