0Pricing
TypeScript Academy · Leçon

Espaces de noms ou modules : usage moderne

Comprenez pourquoi les modules sont préférés aux espaces de noms

Espaces de noms ou modules : usage moderne est une leçon TypeScript Academy gratuite sur CoddyKit. Ceci est la leçon 4 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

TypeScript disposait à l’origine d’espaces de noms (anciennement appelés « modules internes ») pour organiser le code. Le TypeScript moderne utilise plutôt les modules ES. Cette leçon explique dans quels cas chacun convient.

Qu’est-ce qu’un espace de noms

Un espace de noms est une manière propre à TypeScript de regrouper du code associé dans une portée nommée à l’aide du mot-clé `namespace`.
namespace Geometry {
  export interface Point { x: number; y: number; }
  export function distance(a: Point, b: Point): number {
    return Math.sqrt((a.x - b.x) ** 2 + (a.y - b.y) ** 2);
  }
}

Accéder aux membres d’un espace de noms

Accédez aux membres d’un espace de noms en utilisant son nom et la notation avec un point.
const p1: Geometry.Point = { x: 0, y: 0 };
const p2: Geometry.Point = { x: 3, y: 4 };
const d = Geometry.distance(p1, p2); // 5

Espaces de noms imbriqués

Les espaces de noms peuvent être imbriqués.
namespace App {
  export namespace Models {
    export interface User { name: string; }
  }
}
const u: App.Models.User = { name: 'Alice' };

Fusion d’espaces de noms

Les espaces de noms prennent en charge la fusion des déclarations : deux déclarations d’espace de noms portant le même nom sont fusionnées.
namespace Validation {
  export function validate(s: string): boolean { return s.length > 0; }
}
namespace Validation {
  export function sanitize(s: string): string { return s.trim(); }
}

Pourquoi les modules sont préférables

Les modules ES sont la norme JavaScript. Ils sont pris en charge par tous les outils de regroupement, optimisés efficacement par élagage de l’arbre et fonctionnent nativement dans les navigateurs modernes et Node.js.

L’équivalent modulaire d’un espace de noms

En TypeScript moderne, un espace de noms devient simplement un fichier. Exportez ce qui doit être public et gardez le reste privé.
// geometry.ts
export interface Point { x: number; y: number; }
export function distance(a: Point, b: Point): number {
  return Math.sqrt((a.x - b.x) ** 2 + (a.y - b.y) ** 2);
}

Les espaces de noms sont toujours utilisés dans les fichiers de déclaration

Les espaces de noms sont encore largement utilisés dans les fichiers de déclaration .d.ts pour les bibliothèques globales (comme les types du DOM et les types de Node.js), car ils étendent la portée globale.
// node.d.ts
declare namespace NodeJS {
  interface ProcessEnv { NODE_ENV?: 'development' | 'production'; }
}

Références triple-slash (ancienne méthode)

Avant les modules ES, les directives triple-slash faisaient référence à d’autres fichiers. Aujourd’hui, tsconfig inclut et les importations de modules les remplacent.
/// <reference types="node" />
/// <reference path="./other.d.ts" />

Quand utiliser encore les espaces de noms

Utilisez les espaces de noms : (1) dans les fichiers de déclaration pour les types globaux ambiants ; (2) lors de l’extension d’espaces de noms globaux existants provenant de bibliothèques.

Migrer des espaces de noms vers les modules

Remplacez `namespace Foo {}` par un fichier de module. Remplacez `/// ` par des importations. L’équipe TypeScript a documenté ce parcours de migration.

Vérification rapide

Dans le TypeScript moderne, quel est le remplacement recommandé des espaces de noms ?

Récapitulatif

Les espaces de noms organisent le code dans une portée nommée, mais sont une fonctionnalité héritée dans le TypeScript moderne. Utilisez les modules ES (import/export) pour le code d’application. Les espaces de noms restent utiles dans les fichiers de déclaration pour étendre les types globaux.

Questions Fréquemment Posées

La leçon « Espaces de noms ou modules : usage moderne » est-elle gratuite ?

Oui — le texte complet de « Espaces de noms ou modules : usage moderne » 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 « Espaces de noms ou modules : usage moderne » ?

Comprenez pourquoi les modules sont préférés aux espaces de noms 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 4 sur 4.

Combien de temps prend la leçon « Espaces de noms ou modules : usage moderne » ?

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