Окружающие объявления (.d.ts) и типы сторонних библиотек
Пишите окружающие объявления в файлах .d.ts для описания глобальных сущностей и модулей; безопасно устанавливайте и используйте типы сторонних библиотек.
«Окружающие объявления (.d.ts) и типы сторонних библиотек» — бесплатный урок TypeScript Academy на CoddyKit. Это урок 2 из 3. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения TypeScript Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс TypeScript Academy содержит 3 уроков всего.
Введение
Цель: описывать внешний JavaScript с помощью деклараций окружения в файлах .d.ts и использовать типы сторонних библиотек для библиотек, в которых отсутствуют типы.
Глобальные декларации
globals.d.ts: объявляйте глобальные переменные и расширяйте интерфейсы окружения (например, Window), не генерируя JS.
// file: globals.d.ts
// Declare global variables and interfaces
declare const VERSION: string;
declare interface Window {
appReady?: boolean;
}Основы лямбды с получателем
- Получатель = экземпляр builder, используемый внутри лямбды.
- Более чистые вызовы: item("Tea") вместо builder.item.
- Делайте имена короткими, а действия — очевидными.
Декларации модулей
declare module описывает пакет, который не поставляет типы. Теперь import { coolify } корректно проходит проверку типов.
// file: cool-lib.d.ts
// Provide types for an untyped JS module
declare module "cool-lib" {
export function coolify(s: string): string;
export const version: string;
}Расширение модулей
Расширение модуля дополняет установленные типы, например добавляет пользовательское свойство в существующий интерфейс.
// file: react-augment.d.ts
// Extend an existing module (augmentation)
declare module "react" {
interface HTMLAttributes<T> {
dataTestId?: string;
}
}Типы сторонних библиотек
Если библиотека не поставляет типы, отдавайте предпочтение пакетам @types/ из DefinitelyTyped. Они добавляют в сборку только файлы .d.ts.
// install: npm i -D @types/lodash
// usage:
import _ from "lodash";
const r = _.chunk([1,2,3,4], 2);Советы и разрешение типов
Советы:
- Размещайте файлы .d.ts в src/ или подключайте их через tsconfig.json (
include/typeRoots/types). - Используйте расширение модуля, чтобы дополнять типы, и не редактируйте node_modules.
- Избегайте слишком широкого типа
any; задавайте минимальные точные структуры.
Проверка деклараций окружения
Быстрая проверка: для чего используется декларация окружения?
Итоги
Итоги: используйте файлы .d.ts для глобальных объектов и модулей, отдавайте предпочтение @types для типов сообщества и безопасно расширяйте типы с помощью расширения модуля.
Итоги
Итоги: Используйте типизированные получатели для каждого блока, добавляйте @DslMarker для безопасной работы с областями видимости и возвращайте неизменяемую модель для удобного использования.
Часто задаваемые вопросы
Урок «Окружающие объявления (.d.ts) и типы сторонних библиотек» бесплатный?
Да — полный текст урока «Окружающие объявления (.d.ts) и типы сторонних библиотек» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс TypeScript Academy, подпишись на CoddyKit PRO. Курс TypeScript Academy содержит 3 уроков всего.
Чему я научусь в уроке «Окружающие объявления (.d.ts) и типы сторонних библиотек»?
Пишите окружающие объявления в файлах .d.ts для описания глобальных сущностей и модулей; безопасно устанавливайте и используйте типы сторонних библиотек. Ты практикуешь TypeScript Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать TypeScript Academy?
Предыдущий опыт не требуется. TypeScript Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 2 из 3.
Сколько времени занимает урок «Окружающие объявления (.d.ts) и типы сторонних библиотек»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке TypeScript Academy?
Да. Каждый урок TypeScript Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Модули ES (именованные и экспорт по умолчанию), повторный экспорт
- Окружающие объявления (.d.ts) и типы сторонних библиотек
- Сопоставление путей и разрешение модулей