Пространства имён и модули: современное применение

Добро пожаловать

Что такое пространство имён

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

Доступ к членам пространства имён

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

Вложенные пространства имён

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

Слияние пространств имён

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

Почему предпочтительны модули

Модульный эквивалент пространства имён

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

Пространства имён всё ещё используются в файлах объявлений

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

Ссылки с тройной косой чертой (устаревший подход)

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

Когда всё ещё следует использовать пространства имён

Переход от пространств имён к модулям

Быстрая проверка

Итоги