Formations — 1 037 leçons en français

Accueil › TypeScript › Les tableaux

Les tableaux

Tableaux, tuples et enumsdebutant

Un tableau s'annote T[] ou Array<T> — les deux notations sont équivalentes, et la première est la plus répandue.

const noms: string[] = ["Ada", "Alan"];
const scores: Array<number> = [12, 15];
const grille: number[][] = [[1, 2], [3, 4]];

TypeScript mémorise le type des éléments, et rien d'autre. Ni la longueur, ni ce qu'il y a à la position 3.

C'est de là que vient le mensonge le plus coûteux du système de types :

const noms: string[] = [];
noms[5].toUpperCase();
// Le compilateur accepte. L'exécution lève :
// TypeError: Cannot read properties of undefined (reading 'toUpperCase')

noms[5] est typé string. Le tableau est vide. Le type affirme une présence que personne n'a vérifiée — et strict: true ne change rien à cela.

L'option noUncheckedIndexedAccess la corrige :

const premier = noms[0];     // string | undefined
premier.toUpperCase();
// Erreur : 'premier' is possibly 'undefined'. ts(18048)

Le code devient un peu plus bavard, et il devient vrai. Trois façons de satisfaire le compilateur, par ordre de préférence : noms.at(0) suivi d'un test, une déstructuration avec valeur par défaut, ou une garde explicite.

Quand une fonction se contente de lire, annotez readonly T[] :

function total(scores: readonly number[]): number {
  return scores.reduce((a, b) => a + b, 0);
}

La signature devient une promesse lisible : cette fonction ne touchera pas au tableau reçu.

Les termes à connaître

`T[]`

La notation courte d'un tableau homogène : string[] est un tableau de chaînes, de longueur quelconque. Forme équivalente et plus verbeuse : Array<string>.

Tableau homogène

Un tableau dont tous les éléments ont le même type. C'est l'hypothèse par défaut de T[] : TypeScript ne mémorise ni la longueur, ni ce qu'il y a à la position 3.

`readonly T[]`

Un tableau dont les méthodes de mutation (push, sort, splice) n'existent pas dans le type. Forme longue : ReadonlyArray<string>. Aucune protection à l'exécution, uniquement au compilateur.

`noUncheckedIndexedAccess`

L'option qui ajoute | undefined au résultat de chaque accès par index. Sans elle, liste[5] est typé comme présent même sur un tableau vide.

`TS18048`

Le code d'erreur « 'x' is possibly 'undefined' ». C'est celui que noUncheckedIndexedAccess fait apparaître partout où le code supposait un élément présent.

Covariance des tableaux

Chien[] est accepté là où Animal[] est attendu. Pratique, et faux : rien n'empêche alors d'ajouter un Chat dans le tableau de chiens.

Prédicat de type

La signature (x: unknown) => x is string, qui permet à filter de rétrécir le type du tableau produit. Sans elle, filter renvoie le même type qu'en entrée.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.