Namespaces versus módulos: uso moderno

Boas-vindas

O que é um espaço de nomes

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);
  }
}

Acessando membros de um espaço de nomes

const p1: Geometry.Point = { x: 0, y: 0 };
const p2: Geometry.Point = { x: 3, y: 4 };
const d = Geometry.distance(p1, p2); // 5

Espaços de nomes aninhados

namespace App {
  export namespace Models {
    export interface User { name: string; }
  }
}
const u: App.Models.User = { name: 'Alice' };

Mesclagem de espaços de nomes

namespace Validation {
  export function validate(s: string): boolean { return s.length > 0; }
}
namespace Validation {
  export function sanitize(s: string): string { return s.trim(); }
}

Por que os módulos são preferidos

O equivalente em módulos a um espaço de nomes

// 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);
}

Espaços de nomes ainda usados em arquivos de declaração

// node.d.ts
declare namespace NodeJS {
  interface ProcessEnv { NODE_ENV?: 'development' | 'production'; }
}

Referências de barra tripla (legado)

/// <reference types="node" />
/// <reference path="./other.d.ts" />

Quando ainda usar espaços de nomes

Migrando de espaços de nomes para módulos

Verificação rápida

Recapitulação