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;

Dafür schreibt man sonst array[array.length - 1] — ein Ausdruck, der bei einem leeren Array undefined liefert und dabei aussieht, als wäre es Absicht. last sagt es geradeheraus und liefert im selben Fall undefined.

Die Form mit n nimmt vom Ende, behält aber die Reihenfolge: last([1, 2, 3], 2) ist [2, 3], nicht [3, 2]. n wird begrenzt: negativ ergibt ein leeres Array, größer als die Länge das ganze Array. Die Eingabe bleibt unverändert.

Parameter

Parameter	Typ	Beschreibung
`array`	`T[]`	Das Array, aus dem gelesen wird. Bleibt unverändert.
`n` (optional)	`number`	Wie viele Elemente genommen werden. Eine ganze Zahl; weglassen für ein einzelnes Element.

Rückgabewert

T | T[] | undefined — das letzte Element oder ein neues Array mit höchstens n Elementen in ursprünglicher Reihenfolge.

Ausnahmen

Ausnahme	Bedingung
`TypeError`	`array` ist kein Array.
`TypeError`	`n` wurde angegeben und ist keine ganze Zahl.

Beispiele

Ein Element oder mehrere

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

Die jüngsten Einträge eines Protokollblatts lesen

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

Begrenzung

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

Siehe auch

first — dieselben zwei Formen, vom Anfang her.
Basis-Werkzeuge

Quellcode

src/lang/array/last.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.