0Pricing
TypeScript Academy · Leçon

Tableaux Readonly et données immuables

Utilisez ReadonlyArray pour empêcher les modifications accidentelles.

Tableaux Readonly et données immuables est une leçon TypeScript Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage TypeScript Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours TypeScript Academy comprend 4 leçons au total.

Bienvenue

Les tableaux modifiables peuvent être modifiés accidentellement depuis n'importe quel endroit de votre code. ReadonlyArray et le modificateur readonly de TypeScript vous aident à imposer l'immuabilité.

Le modificateur readonly sur les tableaux

Ajoutez le modificateur `readonly` avant le type du tableau pour empêcher toute modification. Le tableau peut être lu, mais pas modifié.
const ids: readonly number[] = [1, 2, 3];
// ids.push(4);   // Error
// ids[0] = 99;   // Error
console.log(ids[0]); // OK — reading is fine

La forme générique ReadonlyArray<T>

`ReadonlyArray` est l'équivalent générique de `readonly T[]`. Les deux empêchent l'utilisation de push, pop, splice et l'affectation par index.
const names: ReadonlyArray<string> = ['Alice', 'Bob'];
// names.push('Charlie'); // Error

Renvoyer des tableaux en lecture seule depuis des fonctions

Renvoyez des tableaux en lecture seule depuis les fonctions pour signaler aux appelants que le résultat ne doit pas être modifié.
function getConfig(): readonly string[] {
  return ['host', 'port', 'db'];
}

Paramètres de fonction immuables

Déclarez les paramètres de tableau en lecture seule pour empêcher la fonction de modifier le tableau de l'appelant.
function sum(nums: readonly number[]): number {
  return nums.reduce((a, b) => a + b, 0);
  // nums.push(99); // Error inside function
}

as const pour les tableaux littéraux

L'assertion `as const` rend un tableau accessible en lecture seule et lui attribue un type tuple avec des types littéraux pour ses éléments, au lieu de types élargis.
const colors = ['red', 'green', 'blue'] as const;
// type: readonly ['red', 'green', 'blue']
// colors.push('yellow'); // Error

Le modificateur readonly ne gèle pas profondément

readonly empêche uniquement la modification de la référence du tableau. Si les éléments sont des objets, leurs propriétés peuvent toujours être modifiées.
const users: readonly { name: string }[] = [{ name: 'Alice' }];
// users.push({}); // Error
users[0].name = 'Bob'; // Allowed — object itself is mutable

Immuabilité profonde avec Readonly<T>

Pour rendre les objets profondément immuables, associez ReadonlyArray à Readonly sur les éléments. Vous pouvez également utiliser une bibliothèque comme immer.
type ImmutableUser = Readonly<{ name: string; scores: readonly number[] }>;
const u: ImmutableUser = { name: 'Alice', scores: [90, 85] };
// u.name = 'Bob';       // Error
// u.scores.push(100);  // Error

Affectation entre tableaux modifiables et en lecture seule

Un tableau en lecture seule n'est PAS assignable à un type de tableau modifiable. Cela empêche de transmettre accidentellement un tableau immuable là où une modification est attendue.
const ro: readonly number[] = [1, 2];
const mutable: number[] = ro; // Error!

Quand utiliser des tableaux en lecture seule

Utilisez des tableaux en lecture seule pour les objets de configuration, les constantes, les paramètres de fonction que vous promettez de ne pas modifier et les valeurs renvoyées par les fonctions pures.

La propagation crée un nouveau tableau modifiable

La propagation d'un tableau en lecture seule dans un nouveau littéral de tableau crée une copie modifiable. C'est une manière claire d'effectuer des modifications sans modifier l'original.
const base: readonly number[] = [1, 2, 3];
const extended: number[] = [...base, 4]; // new mutable array

Vérification rapide

Quelle opération n'est PAS autorisée sur un `readonly number[]` dans TypeScript ?

Récapitulatif

Utilisez `readonly T[]` ou `ReadonlyArray` pour empêcher la modification des tableaux. Utilisez `as const` pour les tableaux littéraux constants. La propagation crée une copie modifiable lorsque vous devez étendre un tableau en lecture seule.

Questions Fréquemment Posées

La leçon « Tableaux Readonly et données immuables » est-elle gratuite ?

Oui — le texte complet de « Tableaux Readonly et données immuables » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours TypeScript Academy, passe à CoddyKit PRO. Le cours TypeScript Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Tableaux Readonly et données immuables » ?

Utilisez ReadonlyArray pour empêcher les modifications accidentelles. Tu pratiques TypeScript Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer TypeScript Academy ?

Aucune expérience préalable n'est requise. TypeScript Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.

Combien de temps prend la leçon « Tableaux Readonly et données immuables » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon TypeScript Academy ?

Oui. Chaque leçon TypeScript Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Tableaux typés : T[] et Array
  2. Tableaux Readonly et données immuables
  3. Tuples : tableaux typés de longueur fixe
  4. Énumérations : constantes numériques et textuelles
← Retour à TypeScript Academy