Antwoord.

Namespace (naamruimte) is een mechanisme voor het organiseren van code dat al vóór de tijd van pre-ES6 code bestond, voor het groeperen van logisch gerelateerde entiteiten. Het helpt bij het structureren van grote projecten door klassen, functies, interfaces en typen binnen één naamruimte te groeperen, om naamconflicten te vermijden en de code leesbaarder te maken.

Achtergrond: vóór de komst van de JavaScript ES6-normen gebruikten ontwikkelaars IIFE, objecten en naamruimten om modulariteit te imiteren. TypeScript introduceerde het sleutelwoord namespace (vroeger internal module) voor het groeperen van code.

Probleem: moderne modules (ES6 Module) zijn de standaard geworden, en beide benaderingen (namespace en module) bestaan parallel, wat verwarring kan veroorzaken bij het ontwerpen van architectuur — wanneer gebruik je het beste namespace en wanneer module?

Oplossing: Namespaces zijn nog steeds nuttig voor het groeperen van hulpfuncties en typen in puur TypeScript-projecten (bijvoorbeeld bij het genereren van enkele JS-bestanden met de uitvoeroptie outFile). Voor het scheiden van code tussen bestanden, vooral bij het werken met npm en moderne bundelaars, is het juister om modules te gebruiken. Namespaces worden vaak gebruikt in interne bibliotheken, typeverklaringen en situaties waarin structurering binnen één bestand of in oude code nodig is.

Codevoorbeeld:

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

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

Belangrijke kenmerken:

Stelt je in staat om logisch gerelateerde code te groeperen
Kan klassen, typen, functies, constanten bevatten
Wordt gebruikt met de optie outFile, zelden in moderne projecten met modules

Misleidende vragen.

Als je namespace's uit verschillende bestanden samenvoegt, krijg je dan één namespace of meerdere?

TypeScript voert declaration merging uit — bij overeenkomstige namen worden verschillende delen van de naamruimte samengevoegd tot één, als ze correct zijn aangesproken en zich in hetzelfde bereik bevinden.

// 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;
  }
}
// Na compilatie bevat MathUtil beide methoden

Kun je import/require gebruiken voor namespace zoals voor een module?

Nee, bij namespace is er geen standaard export of benoemde export, het kan niet worden geïmporteerd met de standaard ES6-syntaxis. Namespace is een puur TypeScript-concept dat niet wordt omgezet naar JavaScript-modules.

Kun je waarden uit een namespace in een ander bestand importeren via import?

Nee, om toegang te krijgen tot een namespace vanuit andere bestanden is het nodig om een reference (/// <reference path="..." />) te gebruiken of om te compileren met outFile, import via import is niet mogelijk.

Typische fouten en antipatterns

Namespace en modules in hetzelfde project mixen
Proberen een namespace te importeren als een module
Namespace gebruiken voor elk klein deel van de code (fragmentatie)

Voorbeeld uit het leven

Negatieve case

In een oud project is de logica opgedeeld in tientallen namespace's, dezelfde namen verschenen in verschillende bestanden, wat soms leidde tot onverwachte samenvoegingen of conflicten. Bij de overstap naar een modulaire architectuur werd het verplaatsen van code zeer arbeidsintensief.

Voordelen:

Snelle groepering van functies
Eenvoud voor kleine scripts

Nadelen:

Verwarring met echte modules
Moeilijk te schalen
Moeilijkheid om afhankelijkheden tussen bestanden te beheren

Positieve case

In een grote bibliotheek werd de API gedefinieerd via namespace-verklaringen in één bestand index.d.ts, waarmee alle typen en interfaces werden geharmoniseerd zonder code-implementatie. Dit stelde ons in staat om snel de consumenten van de bibliotheek te typen en eenvoudig het contract tussen teams bij te werken.