Réponse.

Le Namespace (espace de noms) est un mécanisme d'organisation du code qui a vu le jour à l'époque du code pre-ES6 pour regrouper des entités logiquement liées. Il aide à structurer de grands projets en regroupant des classes, des fonctions, des interfaces et des types au sein d'un seul espace de noms, afin d'éviter les conflits de noms et de rendre le code plus lisible.

Historique : Avant l'apparition des normes JavaScript ES6, les développeurs utilisaient des IIFE, des objets et des espaces de noms pour imiter la modularité. TypeScript a introduit le mot-clé namespace (anciennement internal module) pour regrouper le code.

Problème : Les modules modernes (ES6 Module) sont devenus la norme, et les deux approches (namespace et module) existent en parallèle, ce qui entraîne une confusion lors de la conception de l'architecture — quand est-il préférable d'utiliser un namespace et quand un module ?

Solution : Les Namespaces sont toujours utiles pour regrouper des fonctions et des types d'assistance dans des projets purement TypeScript (par exemple, lors de la génération de fichiers JS uniques avec la sortie outFile). Pour la séparation du code entre les fichiers, en particulier lors de l'utilisation de npm et de compileurs modernes, il est plus approprié d'utiliser des modules. Les Namespaces sont souvent utilisés dans des bibliothèques internes, des déclarations de types et des situations où une structuration est nécessaire au sein d'un seul fichier ou dans du code ancien.

Exemple de code :

namespace MyMath {
  export function add(a: number, b: number) {
    return a + b;
  }
}

console.log(MyMath.add(2, 3)); // 5

Caractéristiques clés :

Permet de regrouper du code logiquement lié
Peut contenir des classes, des types, des fonctions, des constantes
Utilisé avec l'option outFile, rarement dans des projets modernes avec des modules

Questions pièges.

Si l'on regroupe des namespaces provenant de différents fichiers, sera-t-il un seul namespace ou plusieurs ?

TypeScript effectue un merging de declarations — lorsqu'un nom est identique, différentes parties de l'espace de noms sont fusionnées en une seule, si elles sont correctement référencées et se trouvent dans le même scope.

// mathA.ts
namespace MathUtil {
  export function sum(a: number, b: number) {
    return a + b;
  }
}

// mathB.ts
namespace MathUtil {
  export function mul(a: number, b: number) {
    return a * b;
  }
}
// Après compilation, MathUtil contient les deux méthodes

Peut-on utiliser import/require pour un namespace comme pour un module ?

Non, un namespace n'a pas d'export par défaut/export nommé, il ne peut pas être importé avec la syntaxe standard ES6. Le Namespace est un concept purement TypeScript qui ne se traduit pas en modules JavaScript.

Peut-on importer des valeurs d'un namespace dans un autre fichier via import ?

Non, pour accéder à un namespace depuis d'autres fichiers, il est nécessaire d'utiliser une référence (/// <reference path="..." />) ou de compiler avec outFile, l'import via import est impossible.

Erreurs typiques et anti-patterns

Mélanger des namespaces et des modules dans un même projet
Tenter d'importer un namespace comme un module
Utiliser un namespace pour chaque petite partie de code (fragmentation)

Exemple de la vie réelle

Cas négatif

Dans un ancien projet, la logique a été divisée en dizaines de namespaces, les mêmes noms étant utilisés dans plusieurs fichiers, ce qui entraînait parfois des fusions inattendues ou des conflits. Lors du passage à une architecture modulaire, le transfert du code est devenu très laborieux.

Avantages :

Regroupement rapide des fonctions
Simplicité pour les petits scripts

Inconvénients :

Confusion avec les véritables modules
Difficile à mettre à l'échelle
Complexité de la gestion des dépendances entre fichiers

Cas positif

Dans une grande bibliothèque, l'API a été déclarée via des déclarations de namespace dans un fichier index.d.ts, unifiant tous les types et interfaces sans code d'implémentation. Cela a permis de typiser rapidement les consommateurs de la bibliothèque et de mettre à jour facilement le contrat entre les équipes.