Для чего нужны d.ts файлы?

Question

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

YeaHub · Accepted Answer

TypeScript компилируется в JavaScript, но для работы с существующим JS-кодом ему нужно знать о типах этого кода. .d.ts файлы решают эту задачу.Основные сценарии использования:Описание типов для сторонних JavaScript-библиотек:Когда вы устанавливаете библиотеку через npm (например, lodash), TypeScript ищет соответствующий файл деклараций (например, @types/lodash), чтобы "понять", какие функции и классы предоставляет эта библиотека и какие у них типы.Описание глобальных переменных:Если в вашем проекте есть глобальные переменные, добавленные через тег <script> или другими способами, вы можете описать их в .d.ts файле.typescript// globals.d.ts
declare const MY_GLOBAL_CONFIG: {
  apiUrl: string;
};

declare function myGlobalFunction(msg: string): void;После этого вы можете использовать MY_GLOBAL_CONFIG и myGlobalFunction в любом месте вашего TypeScript-кода без ошибок.Описание модулей:Вы можете описать модуль, для которого нет типов.typescript// declarations.d.ts
declare module 'some-untyped-js-library' {
  export function doSomethingCool(input: string): number;
  const defaultExport: any;
  export default defaultExport;
}Разделение типов и реализации в собственном коде:Иногда полезно вынести сложные типы интерфейсов в отдельные .d.ts файлы для лучшей организации кода. В таких файлах можно объявлять типы, интерфейсы и т.д., но не значения (функции, классы, переменные).typescript// types/user.d.ts
export interface User {
  id: number;
  name: string;
}

// user-service.ts
import { User } from './types/user';
export function getUser(): User { ... }Вывод: .d.ts файлы — это фундаментальная часть экосистемы TypeScript, которая обеспечивает безопасность типов при интеграции с огромным миром JavaScript-библиотек и кода. Они позволяют писать типизированный код, даже опираясь на нетипизированные зависимости.