0Pricing
TypeScript Academy · Leçon

Bases de .d.ts ; export type ou export

Découvrez les bases des fichiers de déclaration : déclarations ambiantes ou de modules, export type ou export, et amélioration du DX pour les utilisateurs.

Bases de .d.ts ; export type ou export est une leçon TypeScript Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 2. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage TypeScript Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours TypeScript Academy comprend 2 leçons au total.

Introduction

Objectif : écrire des fichiers .d.ts utiles. Vous apprendrez à distinguer les déclarations ambiantes des déclarations de module, à déclarer des exportations et à choisir entre export type et export.

  • Contexte ambiant ou de module
  • Exportations de types uniquement ou de valeurs
  • Bonnes pratiques

Déclarations ambiantes

Utilisez declare global pour étendre la portée globale. Ajoutez export {} pour marquer le fichier comme module et éviter les conflits.

// 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

Déclarations de module

declare module décrit la structure d’un paquet externe. Utilisez des exportations à l’intérieur pour refléter ce que fournit le code JS.

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

Exportation de type ou exportation

export type (ou une interface) sert aux constructions réservées aux types. Utilisez export pour les fonctions, constantes et classes, c’est-à-dire les éléments qui existent à l’exécution.

// 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

Enrichissement des modules

Vous pouvez enrichir des modules existants en les rouvrant dans un autre fichier de déclaration. Cette technique est utile pour corriger des paquets tiers.

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

Bonnes pratiques

Bonnes pratiques :

  • Gardez les fichiers .d.ts minimaux ; évitez les variables globales inutiles.
  • Séparez clairement les exportations de types et de valeurs.
  • Vérifiez les fichiers de déclaration avec tsc --noEmit et un exemple d’utilisation.

Vérification de l’utilisation de export type

Vérification rapide : quand devez-vous utiliser export type ?

Récapitulatif

Récapitulatif : les fichiers .d.ts déclarent des types sans implémentation. Utilisez declare global ou declare module, séparez export type de export et suivez les bonnes pratiques.

Questions Fréquemment Posées

La leçon « Bases de .d.ts ; export type ou export » est-elle gratuite ?

Oui — le texte complet de « Bases de .d.ts ; export type ou export » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours TypeScript Academy, passe à CoddyKit PRO. Le cours TypeScript Academy comprend 2 leçons au total.

Qu'est-ce que j'apprendrai dans « Bases de .d.ts ; export type ou export » ?

Découvrez les bases des fichiers de déclaration : déclarations ambiantes ou de modules, export type ou export, et amélioration du DX pour les utilisateurs. Tu pratiques TypeScript Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer TypeScript Academy ?

Aucune expérience préalable n'est requise. TypeScript Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 2.

Combien de temps prend la leçon « Bases de .d.ts ; export type ou export » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon TypeScript Academy ?

Oui. Chaque leçon TypeScript Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Bases de .d.ts ; export type ou export
  2. Publier des packages avec leurs types
← Retour à TypeScript Academy