Оголошення та злиття

Файли декларації типу (з розширенням .d.ts) використовуються в TypeScript для опису форми існуючого коду JavaScript без реалізації будь-якої фактичної логіки. Вони містять лише визначення типів, інтерфейси та сигнатури функцій.

Ці файли необхідні при використанні сторонніх бібліотек, написаних чистим JavaScript.

Злиття декларацій

Об’єднання декларацій — це поведінка, за якої компілятор об’єднує дві або більше окремих декларацій, оголошених з однаковою назвою, в одне визначення.

Найпоширенішим випадком є ​​злиття інтерфейсу:

interface User {
  name: string;
}

interface User {
  age: number;
}

// The resulting User interface has both name and age properties!
const student: User = {
  name: 'Alice',
  age: 23,
};

Якщо властивості мають однакові назви, вони мають бути одного типу, інакше TypeScript повідомить про помилку.

Зміна глобальних і зовнішніх модулів

Ми можемо використовувати злиття декларацій для розширення інтерфейсів, визначених в інших модулях або в глобальній області видимості.

Наприклад, якщо ми хочемо додати властивість до глобального об’єкта браузера window:

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

Використовуючи declare global, ми повідомляємо TypeScript, що вставляємо новий підпис в існуючий глобальний інтерфейс Window.

Спробуйте самі

Вправа 1: Об’єднання базових декларацій

Вправа 2: Розширення інтерфейсу глобального вікна