Declaration merging in plain JS with JSDoc

Offen
#57,559 9 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Anfängerfreundlichkeit
25/100
Issue-Typ
Feature
Klarheit
Muss geklärt werden
Aktivitätsstatus
Veraltet
Tech-Stack
javascript, typescript
Bereich
compilers

Rechercherichtung

Beginne mit den motivierenden TypeScript- und plain-JavaScript-Beispielen im Issue und lies dann die Diskussion, um das vorgeschlagene Verhalten von declaration merging und die bestehenden Einschränkungen zu verstehen. Als abgeschlossen gilt die Aufgabe, wenn ein praktikables JSDoc-Design feststeht und declaration merging implementiert ist, ohne das ausgegebene JavaScript oder das bestehende Laufzeitverhalten zu ändern.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

Awaiting More Feedback Suggestion
🔍 Search Terms

jsdoc declaration merging

✅ Viability Checklist
⭐ Suggestion

Ability to merge declarations.

📃 Motivating Example

For example, this is a declaration merge in TS:

export const Foo = makeFooClass()
export type Foo = InstanceType<typeof Foo>

In JS we can't do this. I was hoping for something similar to this to achieve the same:

export const Foo = makeFooClass() // returns a class
/** @export {InstanceType<typeof Foo>} Foo */
💻 Use Cases
  1. What do you want to use this for? To merge declarations in certain cases.
  2. What shortcomings exist with current approaches? There's no way to do it AFAICT
  3. What workarounds are you using in the meantime? None
Vorherrschende Sprache
Go
Sterne
111k
Forks
14.4k
Ø Merge
1 T. 19 Std.
Gemergte PRs (30 T.)
117

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus microsoft/TypeScript

Alle Issues in microsoft/TypeScript

Ähnliche Issues

Weitere Issues zu Go

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.