0Pricing
TypeScript Academy · Lekcja

Podstawy .d.ts; export type a export

Podstawy plików deklaracji: deklaracje ambient a modułowe, export type a export oraz zapewnianie właściwego DX odbiorcom

Podstawy .d.ts; export type a export to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 1 z 2. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej TypeScript Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs TypeScript Academy zawiera 2 lekcji w sumie.

Wprowadzenie

Cel: Tworzyć użyteczne pliki .d.ts. Należy poznać deklaracje ambientowe i modułowe, sposób deklarowania eksportów oraz sytuacje, w których używa się export type zamiast export.

  • Kontekst ambientowy i modułowy
  • Eksporty wyłącznie typów a eksporty wartości
  • Dobre praktyki

Deklaracje ambientowe

Należy używać declare global do rozszerzania zakresu globalnego. Dodanie export {} oznacza plik jako moduł i pozwala uniknąć konfliktów.

// globals.d.ts
// Ambient declaration: no import/export, augments global scope
declare global {
  interface Window {
    APP_VERSION: string
  }
}

export {} // ensures this file is a module

Deklaracje modułów

declare module opisuje strukturę zewnętrznego pakietu. Eksporty wewnątrz powinny odzwierciedlać to, co udostępnia kod JS.

// types/index.d.ts
// Declare a module with exports
declare module "mylib" {
  export function greet(name: string): string
  export const version: string
}

Export type a export

export type (lub interface) służy do konstrukcji istniejących wyłącznie na poziomie typów. export należy stosować dla funkcji, stałych i klas — elementów istniejących w czasie działania.

// shapes.d.ts
export type Point = { x: number; y: number }

export interface User {
  id: string
  name: string
}

export function distance(a: Point, b: Point): number
export const VERSION: string

Rozszerzanie modułów

Istniejące moduły można rozszerzać, otwierając je ponownie w innym pliku deklaracji. Jest to przydatne do uzupełniania pakietów innych firm.

// augment.d.ts
import "mylib"
declare module "mylib" {
  export function extra(): void
}

Najlepsze praktyki

Najlepsze praktyki:

  • Pliki .d.ts powinny być minimalne; należy unikać niepotrzebnych zmiennych globalnych.
  • Eksporty wyłącznie typów i eksporty wartości należy wyraźnie rozdzielać.
  • Pliki deklaracji należy testować za pomocą tsc --noEmit oraz przykładowego użycia.

Sprawdzenie export type

Szybkie sprawdzenie: Kiedy należy używać export type?

Podsumowanie

Podsumowanie: Pliki .d.ts deklarują typy bez implementacji. Należy używać declare global lub declare module, rozdzielać export type i export oraz stosować dobre praktyki.

Często zadawane pytania

Czy lekcja „Podstawy .d.ts; export type a export” jest bezpłatna?

Tak — pełny tekst „Podstawy .d.ts; export type a export” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu TypeScript Academy, przejdź na CoddyKit PRO. Kurs TypeScript Academy zawiera 2 lekcji w sumie.

Co nauczysz się w „Podstawy .d.ts; export type a export”?

Podstawy plików deklaracji: deklaracje ambient a modułowe, export type a export oraz zapewnianie właściwego DX odbiorcom Ćwiczysz TypeScript Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć TypeScript Academy?

Nie wymagamy żadnego doświadczenia. TypeScript Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 2.

Ile czasu zajmuje lekcja „Podstawy .d.ts; export type a export”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji TypeScript Academy?

Tak. Każda lekcja TypeScript Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Podstawy .d.ts; export type a export
  2. Publikowanie pakietów z typami
← Powrót do TypeScript Academy