0Pricing
TypeScript Academy · Leçon

Réexportations et fichiers d’agrégation

Créez des fichiers index pour simplifier les chemins d’importation

Réexportations et fichiers d’agrégation 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 fichiers d’agrégation (index.ts) regroupent et réexportent le contenu des modules, créant une API publique simple pour un répertoire afin que les consommateurs disposent de chemins d’importation plus clairs.

Qu’est-ce qu’un fichier d’agrégation

Un fichier d’agrégation est un index.ts qui réexporte tout le contenu du même répertoire. Les consommateurs importent depuis le répertoire plutôt que depuis des fichiers individuels.
// src/models/index.ts (barrel)
export { User } from './user';
export { Product } from './product';
export { Order } from './order';

Utiliser le fichier d’agrégation

Importez depuis le fichier d’agrégation plutôt que depuis des fichiers individuels pour obtenir des chemins plus clairs.
// Before barrel:
import { User } from '../models/user';
import { Product } from '../models/product';

// After barrel:
import { User, Product } from '../models';

Réexportation générique `export *`

Réexportez toutes les exportations nommées d’un module avec `export *`.
// index.ts
export * from './utils';
export * from './helpers';
export * from './validators';

Renommer lors d’une réexportation

Vous pouvez renommer les exportations lorsque vous les réexportez.
export { default as MyButton } from './Button';
export { Button as Btn } from './Button';

Réexportations réservées aux types

Réexportez des types sans impact à l’exécution.
export type { User, UserRole } from './user.types';

Fichier d’agrégation pour un module fonctionnel

Dans les grandes applications, les dossiers de fonctionnalités possèdent souvent un fichier d’agrégation qui n’expose que la surface publique.
// features/auth/index.ts
export { AuthProvider } from './AuthProvider';
export { useAuth } from './useAuth';
export type { AuthUser } from './types';

Risque de dépendance circulaire

Les fichiers d’agrégation peuvent introduire des dépendances circulaires si les fichiers du même agrégateur s’importent indirectement par l’intermédiaire de l’index. Soyez vigilant.

Élagage arborescent et fichiers d’agrégation

Les empaqueteurs modernes (Webpack, Rollup, Vite) effectuent l’élagage arborescent des réexportations des fichiers d’agrégation. Seules les exportations réellement utilisées sont incluses dans l’empaquetage.

Fichiers d’agrégation profonds ou superficiels

Imbriquez les fichiers d’agrégation : chaque sous-répertoire possède son propre index.ts, et le fichier d’agrégation parent réexporte le contenu des fichiers d’agrégation des sous-répertoires.
// src/index.ts
export * from './models';
export * from './services';
export * from './utils';

Fichiers d’agrégation et performances de TypeScript

Des fichiers d’agrégation profondément imbriqués peuvent ralentir la compilation de TypeScript. Pour les grands projets, envisagez d’aplatir la structure ou d’utiliser des alias de chemins à la place.

Vérification rapide

Quel est le principal avantage d’utiliser un fichier d’agrégation (index.ts) ?

Récapitulatif

Les fichiers d’agrégation (index.ts) réexportent le contenu d’un répertoire et créent des chemins d’importation clairs. Utilisez `export *` pour les réexportations en masse, `export type` pour les types uniquement, et soyez conscient des risques de dépendances circulaires dans les grands projets.

Questions Fréquemment Posées

La leçon « Réexportations et fichiers d’agrégation » est-elle gratuite ?

Oui — le texte complet de « Réexportations et fichiers d’agrégation » 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 « Réexportations et fichiers d’agrégation » ?

Créez des fichiers index pour simplifier les chemins d’importation 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 « Réexportations et fichiers d’agrégation » ?

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. Syntaxe des modules ES : import et export
  2. Réexportations et fichiers d’agrégation
  3. Importations et exportations réservées aux types
  4. Espaces de noms ou modules : usage moderne
← Retour à TypeScript Academy