0Pricing
TypeScript Academy · Leçon

Déclarations ambiantes (.d.ts) et typages de bibliothèques tierces

Écrivez des déclarations ambiantes dans des fichiers .d.ts pour décrire les variables globales et les modules ; installez et utilisez les typages de bibliothèques tierces en toute sécurité.

Déclarations ambiantes (.d.ts) et typages de bibliothèques tierces est une leçon TypeScript Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 3. 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 3 leçons au total.

Introduction

Objectif : décrire du JavaScript externe avec des déclarations ambiantes dans des fichiers .d.ts et utiliser des définitions de types tierces pour les bibliothèques dépourvues de types.

Déclarations globales

globals.d.ts : déclarez des éléments globaux et étendez des interfaces ambiantes (par exemple, Window) sans générer de JS.

// file: globals.d.ts
// Declare global variables and interfaces
declare const VERSION: string;
declare interface Window {
  appReady?: boolean;
}

Notions de base des lambdas avec récepteur

  • Le récepteur correspond à l’instance du générateur utilisée dans la lambda.
  • Appels plus clairs : item("Tea") au lieu de builder.item.
  • Gardez des noms courts et des actions évidentes.

Déclarations de modules

declare module décrit un paquet qui ne fournit aucun type. Désormais, import { coolify } est correctement vérifié par le système de types.

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

Extension de module

L’extension de module étend les définitions de types installées, par exemple en ajoutant une propriété personnalisée à une interface existante.

// file: react-augment.d.ts
// Extend an existing module (augmentation)
declare module "react" {
  interface HTMLAttributes<T> {
    dataTestId?: string;
  }
}

Définitions de types tierces

Préférez les paquets @types/ de DefinitelyTyped lorsqu’une bibliothèque ne fournit aucun type. Ils ajoutent uniquement des fichiers .d.ts à votre compilation.

// install: npm i -D @types/lodash
// usage:
import _ from "lodash";
const r = _.chunk([1,2,3,4], 2);

Conseils et résolution

Conseils :

  • Placez vos fichiers .d.ts sous src/ ou incluez-les via tsconfig.json (include/typeRoots/types).
  • Utilisez l’extension de module pour étendre les types ; évitez de modifier node_modules.
  • Évitez un any trop général ; spécifiez des structures minimales et précises.

Vérification des déclarations ambiantes

Vérification rapide : à quoi sert une déclaration ambiante ?

Récapitulatif

Récapitulatif : utilisez les fichiers .d.ts pour les éléments globaux et les modules, préférez @types pour les définitions de types communautaires et étendez-les de manière sûre avec l’extension de module.

Récapitulatif

Récapitulatif : utilisez des récepteurs typés pour chaque bloc, ajoutez @DslMarker pour garantir la sécurité de la portée et renvoyez un modèle immuable pour une utilisation claire.

Questions Fréquemment Posées

La leçon « Déclarations ambiantes (.d.ts) et typages de bibliothèques tierces » est-elle gratuite ?

Oui — le texte complet de « Déclarations ambiantes (.d.ts) et typages de bibliothèques tierces » 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 3 leçons au total.

Qu'est-ce que j'apprendrai dans « Déclarations ambiantes (.d.ts) et typages de bibliothèques tierces » ?

Écrivez des déclarations ambiantes dans des fichiers .d.ts pour décrire les variables globales et les modules ; installez et utilisez les typages de bibliothèques tierces en toute sécurité. 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 2 sur 3.

Combien de temps prend la leçon « Déclarations ambiantes (.d.ts) et typages de bibliothèques tierces » ?

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. Modules ES (nommés ou par défaut), réexportations
  2. Déclarations ambiantes (.d.ts) et typages de bibliothèques tierces
  3. Mappage des chemins et résolution des modules
← Retour à TypeScript Academy