Hva er hovedbruk av index.d.ts i Typescript?

Jeg har sett noen prosjekter som deklarerer alle typene i index.d.ts. Slik at programmereren ikke trenger å eksplisitt importere typen fra andre filer.

import { TheType } from './somefile.ts'

Er det riktig bruk av index.d.ts-filen? Jeg klarer ikke å finne noe i den offisielle dokumentasjonen.

Svar #1

*.d.ts filer brukes til å gi TypeScript-typeinformasjon om en modul som er skrevet i JavaScript, for eksempel underscore/lodash/aws-sdk.

Dette vil tillate deg å bruke JavaScript-modulene uten behov for å konvertere dem til TS uten å få noen form for feil i koden din.

for eksempel, hvis du har en mappe myAwesomeLib, med filene index.js og index.d.ts

på koden din, vil du kunne importere koden med

import { SomeMethod } from './myAwesomeLib';

eller

import { SomeMethod } from './myAwesomeLib/index';

din TypeScript vil være avhengig av .d.ts-filen for å finne de riktige typene for SomeMethod

Rediger: Mer om deklarasjonsfiler https://basarat.gitbooks.io/typescript/docs/types/ambient/d.ts.html

Svar #2

Det er likt en .h-fil i C, eller du kan forestille deg et grensesnitt-subsystem i et hvilket som helst annet språk som Java eller PHP

Filen inneholder funksjonsprototypen (deklarasjon og typing) til et underliggende bibliotek

for referanse om hvordan man genererer en .d.ts-fil fra en library.js, se https://www.typescriptlang.org/docs/handbook/declaration-files/dts-from-js.html