0Pricing
TypeScript Academy · Lezione

Dichiarazioni ambientali (.d.ts) e tipizzazioni di terze parti

Scriva dichiarazioni ambientali nei file .d.ts per descrivere globali e moduli; installi e utilizzi in sicurezza le tipizzazioni di terze parti.

Dichiarazioni ambientali (.d.ts) e tipizzazioni di terze parti è una lezione TypeScript Academy gratuita su CoddyKit. Questa è la lezione 2 di 3. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento TypeScript Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso TypeScript Academy include 3 lezioni in totale.

Introduzione

Obiettivo: descrivere JavaScript esterno con dichiarazioni ambient nei file .d.ts e usare le tipizzazioni di terze parti per le librerie prive di tipi.

Dichiarazioni globali

globals.d.ts: dichiari le variabili globali ed estenda le interfacce ambient, ad esempio Window, senza generare JavaScript.

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

Fondamenti delle lambda con receiver

  • Receiver = l'istanza del builder utilizzata all'interno della lambda.
  • Chiamate più pulite: item("Tea") invece di builder.item.
  • Mantenga i nomi brevi e le azioni chiare.

Dichiarazioni di modulo

declare module descrive un pacchetto distribuito senza tipi. Ora import { coolify } viene verificato correttamente dal punto di vista dei tipi.

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

Estensione del modulo

La module augmentation estende le tipizzazioni installate, ad esempio aggiungendo una proprietà personalizzata a un’interfaccia esistente.

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

Tipizzazioni di terze parti

Preferisca i pacchetti @types/ di DefinitelyTyped quando una libreria non fornisce tipi. Aggiungono solo file .d.ts alla build.

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

Suggerimenti e risoluzione

Suggerimenti:

  • Inserisca i file .d.ts in src/ oppure li includa tramite tsconfig.json (include/typeRoots/types).
  • Usi la module augmentation per estendere i tipi ed eviti di modificare node_modules.
  • Eviti any troppo generici; specifichi strutture minime ma accurate.

Verifica delle dichiarazioni ambient

Verifica rapida: a cosa serve una dichiarazione ambient?

Riepilogo

Riepilogo: usi i file .d.ts per globali e moduli, preferisca @types per le tipizzazioni della community ed estenda i tipi in modo sicuro con la module augmentation.

Riepilogo

Riepilogo: utilizzi receiver tipizzati per ogni blocco, aggiunga @DslMarker per garantire la sicurezza dell’ambito e restituisca un modello immutabile per un utilizzo chiaro.

Domande Frequenti

La lezione «Dichiarazioni ambientali (.d.ts) e tipizzazioni di terze parti» è gratuita?

Sì — il testo completo di «Dichiarazioni ambientali (.d.ts) e tipizzazioni di terze parti» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso TypeScript Academy, passa a CoddyKit PRO. Il corso TypeScript Academy include 3 lezioni in totale.

Cosa imparerò in «Dichiarazioni ambientali (.d.ts) e tipizzazioni di terze parti»?

Scriva dichiarazioni ambientali nei file .d.ts per descrivere globali e moduli; installi e utilizzi in sicurezza le tipizzazioni di terze parti. Eserciti TypeScript Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare TypeScript Academy?

Non è richiesta alcuna esperienza precedente. TypeScript Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 3.

Quanto tempo richiede la lezione «Dichiarazioni ambientali (.d.ts) e tipizzazioni di terze parti»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione TypeScript Academy?

Sì. Ogni lezione TypeScript Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

  1. Moduli ES (named e default), riesportazioni
  2. Dichiarazioni ambientali (.d.ts) e tipizzazioni di terze parti
  3. Mappatura dei percorsi e risoluzione dei moduli
← Torna a TypeScript Academy