microsoft / microsoft/TypeScript
Suggestion: Upper-bound generic type constraints
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- Go
- Sterne
- 111k
- Forks
- 14.3k
- Ø Merge
- 1 T. 19 Std.
- Gemergte PRs (30 T.)
- 117
Beschreibung
This is a proposal for generic structural supertype constraints.
I'll first detail the proposal, and then get into a discussion about use-cases.
Proposal
A supertype constraint is a constraint on a generic type parameter to be the structural supertype of another type. It's like a subtype/inheritance constraint, but from the other direction. For example, let's say we have a square:
interface Square {width : number; height : number}
In this suggested syntax, you could write:
performAction<T extended by Square>(partialSquare : T) {}
This means the type T must be a structural supertype of square. So the potential candidates for T are:
{width : number}, {height : number}, Square, {}
It's an established kind of type constraint, not something I just made up. Although it's not exactly common, some languages do implement this feature, such as Scala. In Scala, you can write:
def performAction[T >: Square](obj : T) = { ... }
To express a supertype/upper bound constraint. In this case, of course, the constraint isn't structural -- T must declare that it implements Square.
Utility
In most languages, including Scala, this kind of constraint isn't very useful. It only comes up in certain specific situations.
However, Javascript libraries often have this kind of API, where you're allowed to specify the partial properties of an object to modify it (the rest remain at their previous value).
In many cases, you can support this by having optional interface members, but isn't always possible or correct.
An important example is React, which defines a method called setState:
class Component {
var state;
setState(partialState) {
//merges the properties of partialState with the current state.
}
}
The right signature for this method should be:
class Component<Props, State> {
setState<PartialState extended by State>(partialState : PartialState) {
//merges the properties of partialState with the current state.
}
}
Currently,the definition files state that it is:
setState(fullState : State) {
//merges the properties of partialState with the current state.
}
Which doesn't fully capture the functionality of the method.
Notes
The suggested syntax doesn't give us a nice way of combining both subtype and supertype constraints. One possibility is:
exampleMethod<T extends LowerBound and extended by UpperBound>
Beitragsleitfaden
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Der Issue nennt keine Datei, keinen Test und keinen Einstiegspunkt für die Implementierung; beginne damit, den Vorschlag und sein React setState-Beispiel zu lesen, und ermittle dann die Bereiche für generische Einschränkungen und Typprüfung im Repository. Dafür wären eine vereinbarte Syntax und Semantik für strukturelle Supertyp-Einschränkungen erforderlich, einschließlich der Wechselwirkung mit unteren Schranken, aber der Issue definiert diese Details nicht.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- typescript
- Bereich
- compilers
- Issue-Typ
- Feature
- Schwierigkeit
- 5/5
- Geschätzter Aufwand
- Über eine Woche
- Aktivitätsstatus
- Veraltet
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 20/100