Qual è la differenza tra "declare class" e "interface" in TypeScript

In TypeScript, quando si creano file di dichiarazione del sorgente .d.ts, quale è preferibile e perché?

declare class Example {
    public Method(): void; 
}

o

interface Example {
    Method(): void;
}

Le differenze che posso dire sono che le interfacce non possono avere metodi statici, quindi devi usare una classe per questo. Entrambi non producono alcun output JS, quindi forse non importa?

interfaceserve per descrivere semplicemente la forma di un oggetto. Non c'è mai nessuna generazione di codice per le interfacce: sono solo un artefatto nel sistema di tipi. Non vedrai alcuna differenza nella generazione del codice per una classe a seconda che abbia o meno una implementsclausola.

declare classserve quando vuoi descrivere una classe esistente (di solito una classe TypeScript, ma non sempre) che sarà presente esternamente (ad esempio, hai due file .ts che si compilano in due file .js ed entrambi sono inclusi tramite scripttag in una pagina web). Se erediti da un classusing extends(indipendentemente dal fatto che il tipo di base fosse a declare classo normale class) il compilatore genererà tutto il codice per collegare la catena di prototipi e i costruttori di inoltro e cosa no.

Se si tenta di ereditare da un'interfaccia declare classche avrebbe dovuto essere, si verificherà un errore di runtime perché il codice generato farà riferimento a un oggetto senza manifestazione di runtime.

Al contrario, se hai semplicemente implementun'interfaccia che avrebbe dovuto essere a declare class, dovrai reimplementare tutti i membri da solo e non trarrai vantaggio dal riutilizzo del codice dalla potenziale classe base e dalle funzioni che controlla la catena del prototipo in fase di esecuzione rifiuterà il tuo oggetto in quanto non è effettivamente un'istanza della classe base.

Per diventare davvero nerd, se hai uno sfondo C ++, puoi pensare interfacepiù typedefo meno declare classcome e come una externdichiarazione di un costruttore a cui manca rigorosamente una definizione in questa unità di compilazione.

Dal punto di vista del consumo puro (scrivere codice imperativo, non aggiungere nuovi tipi), l'unica differenza tra interfacee declare classè che non puoi newun'interfaccia. Tuttavia, se intendi extend/ implementuno di questi tipi in un nuovo class, devi assolutamente aver scelto correttamente tra interfacee declare class. Solo uno di loro funzionerà.

Due regole che ti serviranno bene:

• Il nome del tipo si allinea con una funzione di costruzione (qualcosa invocabile con new) che è effettivamente presente in fase di esecuzione (ad esempio Dateè, ma JQueryStaticnon lo è)? Se no , lo vuoi sicuramenteinterface
• Ho a che fare con una classe compilata da un altro file TypeScript o qualcosa di sufficientemente simile? Se sì , usadeclare class

Puoi implementare l'interfaccia:

class MyClass implements Example {
    Method() {

    }
}

Considerando che la declare classsintassi è realmente intesa per essere utilizzata per aggiungere definizioni di tipo per codice esterno che non è scritto in TypeScript, quindi l'implementazione è "altrove".

In parole povere, declareviene utilizzato in .ts/ d.tsfiles per dire al compilatore che dovremmo aspettarci che la parola chiave siamo declaringpresenti in quell'ambiente, anche se non è definita nel file presente. Questo ci consentirà quindi di avere l'indipendenza dai tipi quando si utilizza l'oggetto dichiarato, poiché il compilatore Typescript ora sa che qualche altro componente può fornire quella variabile.

Differenza tra declaree interfacein TS:

dichiarare:

declare class Example {
    public Method(): void; 
}

Nel codice sopra si declarefa sapere al compilatore TS che da qualche parte Exampleè dichiarata la classe . Ciò non significa che la classe sia magicamente inclusa. Tu come programmatore sei responsabile di avere la classe disponibile quando la dichiari (con la declareparola chiave).

interfaccia:

interface Example {
    Method(): void;
}

An interfaceè un costrutto virtuale che esiste solo all'interno di un dattiloscritto. Il compilatore dattiloscritto lo utilizza per il solo scopo di controllo del tipo. Quando il codice viene compilato in javascript, l'intero costrutto verrà rimosso. Il compilatore di dattiloscritti utilizza interfacce per verificare se gli oggetti hanno la struttura corretta.

Ad esempio quando abbiamo la seguente interfaccia:

interface test {
  foo: number,
  bar: string,
}

Gli oggetti che definiamo che hanno questo tipo di interfaccia devono corrispondere esattamente all'interfaccia:

// perfect match has all the properties with the right types, TS compiler will not complain.
  const obj1: test = {   
    foo: 5,
    bar: 'hey',
  }