Declaration Files

Ви можете повідомити TypeScript, що ви намагаєтеся описати код, який існує в іншому місці (наприклад, написаний у JavaScript/CoffeeScript/середовищі виконання, як-от браузер або Node.js), використовуючи ключове слово declare. Як короткий приклад:

foo = 123; // Error: `foo` is not defined

vs.

declare var foo: any;
foo = 123; // allowed

Ви можете розмістити ці оголошення у файлі .ts або у файлі .d.ts. Ми настійно рекомендуємо, щоб у ваших реальних проектах ви використовували окремий .d.ts (почніть з такого, який називається щось на зразок global.d.ts або vendor.d.ts).

Якщо файл має розширення .d.ts, тоді кожне визначення кореневого рівня має мати префікс ключового слова declare. Це допомагає автору зрозуміти, що no code emitted by TypeScript. Автор повинен переконатися, що оголошений елемент існуватиме під час виконання.

• Оголошення навколишнього середовища - це обіцянка, яку ви робите з компілятором. Якщо вони не існують під час виконання, і ви спробуєте їх використати, все буде зламано без попередження.

• Оголошення середовища схожі на документи. Якщо джерело змінюється, документи потрібно постійно оновлювати. Отже, у вас може бути нова поведінка, яка працює під час виконання, але ніхто не оновив декларацію середовища, і, отже, ви отримуєте помилки компілятора.