Как объявить глобальную константу в .d.ts-файле?

Что такое .d.ts-файл?

Файлы с расширением .d.ts — это декларации типов TypeScript. Они описывают структуру существующего кода (например, глобальных переменных, библиотек) без реализации. Это позволяет компилятору проверять типы, не выполняя код.

Объявление глобальной константы

Чтобы объявить глобальную константу, используйте ключевое слово declare. Оно указывает TypeScript, что переменная уже существует в окружении (например, задана через window или внешний скрипт).

// globals.d.ts
declare const API_URL: string;
declare const MAX_RETRIES: number;

После этого в любом файле проекта можно использовать API_URL без ошибок типов. Важно: declare не создаёт переменную в рантайме — она должна быть определена где-то ещё (например, в HTML-скрипте).

Где применяется?

Этот подход полезен при работе с глобальными переменными, которые задаются сервером или внешними библиотеками. Например, конфигурация приложения, доступная на всех страницах.

Вывод

Используйте declare const в .d.ts-файлах для типизации глобальных констант. Это делает код безопаснее и понятнее, особенно в больших проектах с общими настройками.