Файлы с расширением .d.ts — это файлы деклараций (Declaration Files). Они не содержат исполняемого кода, а служат только для описания типов данных. Это своего рода «контракт» или «заголовочный файл» для TypeScript.
Они необходимы, когда вы используете библиотеки, написанные на чистом JavaScript. С помощью .d.ts файлов мы сообщаем компилятору TypeScript, какие функции, классы и переменные существуют в библиотеке и какие у них типы, чтобы работали автодополнение и проверка ошибок, даже если исходный код библиотеки не типизирован.
- Модуль 1: Введение в TypeScript
- Модуль 2: Примитивные типы
- Модуль 3: Специальные типы
- Модуль 4: Массивы
- Модуль 5: Кортежи (Tuples)
- Модуль 6: Объекты
- Модуль 7: Функции
- Модуль 8: Union типы
- Модуль 9: Литеральные типы
- Модуль 10: Type Aliases
- Модуль 11: Интерфейсы
- Модуль 12: Type Guards и Narrowing
- Модуль 13: Enums
- Модуль 14: Классы
- Модуль 15: Generics — основы
- Модуль 16: Generics — ограничения
- Модуль 17: Utility Types — базовые
- Модуль 18: Utility Types — работа с Union
- Модуль 19: Utility Types — функции
- Модуль 20: Type Assertions
- Модуль 21: Keyof и Typeof операторы
- Модуль 22: Mapped Types
- Модуль 23: Conditional Types
- Модуль 24: Discriminated Unions
- Модуль 25: Модули и типы
- Модуль 26: Declaration Files
- Что такое .d.ts файлы.
- Declare keyword.
- @types пакеты.
- Модуль 27: Типизация асинхронного кода
- Модуль 28: Практические паттерны
1. Код vs Декларации
Перед вами фрагменты кода TypeScript, которые могут относиться либо к файлам реализации (.ts), либо к файлам описания типов (.d.ts). Разнесите их по двум категориям: 'Файл .ts (реализация)' и 'Файл .d.ts (описание типов)'. Обратите внимание, что файлы .d.ts содержат только декларации типов без реализации кода, тогда как .ts файлы включают исполняемый код. Каждый элемент должен оказаться ровно в одной категории.
function add(a: number, b: number): number { return a + b; }declare function add(a: number, b: number): number;interface Point { x: number; y: number; }export const PI = 3.14;type UserRole = 'admin' | 'user' | 'guest';class Calculator { add(a: number, b: number): number { return a + b; } }declare class Calculator { add(a: number, b: number): number; }export default function greet(name: string): string { return `Hello, ${name}!`; }2. Ключевое слово declare
В этом задании вам нужно дополнить фрагмент кода файла декларации TypeScript (.d.ts), объявив глобальную переменную. Ключевое слово `declare` пропущено, и вам необходимо вставить его в указанное место, чтобы объявление стало корректным. Убедитесь, что синтаксис соответствует TypeScript и файл декларации может быть использован для описания глобальных переменных без реализации.
// Файл декларации .d.ts
input1S var myGlobalVar: string;
// Глобальная переменная для использования в проекте3. Запрет реализации
В этом фрагменте кода файла деклараций TypeScript (.d.ts) допущена ошибка, связанная с запретом реализации. Найдите строку с ошибкой и исправьте её, чтобы файл соответствовал правилам объявления типов.
// Файл: utils.d.tsdeclare const MAX_SIZE: number;declare function isReady(): boolean { return true; }declare interface Config { timeout: number;}4. Элементы декларации
Внимательно изучите содержимое файла деклараций TypeScript (.d.ts). Ваша задача — отметить все конструкции, которые определяют типы. К таким конструкциям относятся объявления интерфейсов (interface), псевдонимы типов (type) и объявления глобальных переменных (declare var). Не отмечайте импорты, экспорты, комментарии, объявления функций или другие элементы, которые не определяют типы напрямую.
// Файл: declarations.d.ts
{{import~|~t0}} { SomeType } from './other';
export {{interface~|~t1}} {{MyInterface~|~t2}} {
id: number;
name: string;
}
export {{type~|~t3}} {{MyType~|~t4}} = string | number;
{{declare~|~t5}} {{var~|~t6}} {{myGlobal~|~t7}}: string;
export {{declare~|~t8}} {{function~|~t9}} myFunc(arg: string): void;
// Это комментарий, не определяет тип5. Расширение файла
В этом задании вам предстоит заполнить пропуск в коде, выбрав правильное расширение файла для добавления типов к скачанной JavaScript библиотеке. Вы увидите фрагмент кода с одним пропуском, обозначенным как input1. При клике на пропуск откроется выпадающий список с вариантами расширений файлов. Ваша задача — выбрать из списка тот вариант, который соответствует файлу деклараций типов в TypeScript. Обратите внимание, что файлы деклараций используются для описания типов существующего JavaScript кода, особенно для библиотек, написанных на JavaScript.
// Мы скачали JS библиотеку и хотим добавить к ней типы.
// Какой файл нужно создать для объявления типов?
const declarationFile: string = 'library' + input1S;6. Описание функции
Из предложенных строк соберите корректную декларацию функции в файле .d.ts. Декларация должна описывать функцию с именем 'calculateDiscount', которая принимает два параметра: 'price' типа number и 'discountPercent' типа number, и возвращает значение типа number. В решении должны использоваться только необходимые строки, лишние строки включать не нужно. Обратите внимание на правильный синтаксис: declare function, имя функции, параметры с типами, тип возвращаемого значения и завершающая точка с запятой.
declare function calculateDiscount(price: number, discountPercent: number): number;declare function calculateDiscount(price: number, discountPercent: number): string;function calculateDiscount(price: number, discountPercent: number): number;declare function calculateDiscount(price: number, discountPercent: number);declare function calculateDiscount(price, discountPercent): number;declare function calculateDiscount(price: number, discountPercent: number): number7. Назначение файла
Рассмотрите фрагмент кода на TypeScript, в котором используется файл деклараций (.d.ts). Вопрос: будет ли скомпилирован файл `definitions.d.ts` в `definitions.js`? Введите ответ в виде одного слова: 'нет' или 'false' (без кавычек).
// definitions.d.ts
declare module "my-module" {
export function doSomething(): void;
}
// main.ts
import { doSomething } from "my-module";
doSomething();