Deklaracje i Merging

Pliki deklaracji typów (z rozszerzeniem .d.ts) są używane w TypeScript do opisywania struktury istniejącego kodu JavaScript bez implementowania jakiejkolwiek rzeczywistej logiki. Zawierają one jedynie definicje typów, interfejsów i sygnatur funkcji.

Pliki te są kluczowe, gdy korzystamy z bibliotek zewnętrznych napisanych w czystym JavaScript.

Declaration Merging (Scalanie Deklaracji)

Declaration Merging to zachowanie, w którym kompilator łączy dwie lub więcej osobnych definicji o tej samej nazwie w jedną definicję.

Najczęstszym przypadkiem jest scalanie interfejsów:

interface User {
  name: string;
}

interface User {
  age: number;
}

// Wynikowy interfejs User posiada zarówno właściwość name, jak i age!
const student: User = {
  name: 'Alice',
  age: 23,
};

Jeśli właściwości mają tę samą nazwę, muszą być tego samego typu, w przeciwnym razie TypeScript zgłosi błąd.

Modyfikowanie modułów globalnych i zewnętrznych

Możemy użyć scalania deklaracji (declaration merging) do rozszerzenia interfejsów zdefiniowanych w innych modułach lub w zakresie globalnym.

Na przykład, jeśli chcemy dodać właściwość do globalnego obiektu window w przeglądarce:

declare global {
  interface Window {
    analyticsToken: string;
  }
}

Używając declare global, informujemy TypeScript, że wstawiamy nową sygnaturę do interfejsu Window istniejącego już w zakresie globalnym.

Spróbuj sam

Ćwiczenie 1: Podstawowe scalanie deklaracji

Ćwiczenie 2: Rozszerzanie globalnego interfejsu Window