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;

C'est ce pour quoi l'on écrit array[array.length - 1] — une expression qui renvoie undefined sur un tableau vide tout en ayant l'air délibérée. last le dit franchement et renvoie undefined dans le même cas.

La forme avec n prend par la fin mais conserve l'ordre : last([1, 2, 3], 2) vaut [2, 3], pas [3, 2]. n est borné : un nombre négatif donne un tableau vide, un nombre supérieur à la longueur donne tout le tableau. L'entrée n'est pas modifiée.

Paramètres

Paramètre	Type	Description
`array`	`T[]`	Le tableau dans lequel lire. Il n'est pas modifié.
`n` (facultatif)	`number`	Combien d'éléments prendre. Un entier ; omettez-le pour n'en prendre qu'un.

Valeur de retour

T | T[] | undefined — le dernier élément, ou un nouveau tableau d'au plus n éléments dans leur ordre d'origine.

Exceptions

Exception	Condition
`TypeError`	`array` n'est pas un tableau.
`TypeError`	`n` est fourni et n'est pas un entier.

Exemples

Un élément, ou plusieurs

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

Lire les dernières entrées d'une feuille de journal

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

Bornage

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

Voir aussi

first — les deux mêmes formes, prises par le début.
Utilitaires de base

Code source

src/lang/array/last.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.