Repository navigation
Allow non-polymorphic ("private") extension of base classesΒ #57979
Description
π Search Terms
private non-polymorphic non-assignable inheritance extension subclass change method signature of base class
β Viability Checklist
- This wouldn't be a breaking change in existing TypeScript/JavaScript code
- This wouldn't change the runtime behavior of existing JavaScript code
- This could be implemented without emitting different JS based on the types of the expressions
- This isn't a runtime feature (e.g. library functionality, non-ECMAScript syntax with JavaScript output, new syntax sugar for JS, etc.)
- This isn't a request to add a new utility type: https://github.com/microsoft/TypeScript/wiki/No-New-Utility-Types
- This feature would agree with the rest of our Design Goals: https://github.com/Microsoft/TypeScript/wiki/TypeScript-Design-Goals
β Suggestion
I would like to write an ES6 class that does not inherit the typing of its base class (and thus doesn't expose any properties or methods defined in the base class, unless they are overridden in the subclass). In C++ I would call this "private inheritance", but in short: I would like to be able to use the implementation of a class (by using the super keyword in a method) without declaring my instances to be assignment-compatible.
π Motivating Example
To the best of my knowledge, there are currently no ways to express this in TypeScript. In pure JavaScript, I can write the following:
export class MyTuple extends Array {
constructor(...args) {
super();
this.push(...args);
Object.freeze(this);
}
}Instances of the MyTuple class, despite extending the Array prototype, don't conform to the Array contract, as all of the mutation methods will throw a TypeError. Even worse, direct array element assignment will silently fail, as assignment to a read-only property is simply ignored. However, the only way to get TypeScript to output this JS code is to use a TypeScript class declaration, and these always propagate the base class typings.
In this particular case, the class is a better match for the ReadonlyArray interface, so ideally I could write the following in TypeScript:
export class MyTuple<T> extends private Array<T> implements ReadonlyArray<T> {
constructor(...args: readonly T[]) {
super();
this.push(...args);
Object.freeze(this);
}
}π» Use Cases
- What do you want to use this for?
In my current project, I'm writing a variable-dimensionality geometry library in which thePointclass is a specialization ofArray<number>. Point is a generic class with the signaturePoint<Dims extends number>, so a 2D point is aPoint<2>, a 3D point is aPoint<3>, etc. Using Array as the base class provides a number of advantages, like being able to use.map()in order to create a new Point with the same dimensionality, based on the existing. However, most of the Array functionality shouldn't be exposed to consumers; in particular, anything that modifies the length of the array or creates an array of different length (push,slice, etc) would cause improper typing. - What shortcomings exist with current approaches?
Well, first off, the return type of.map()is incorrect because of Array inheritance in ES6 declaration file (lib.es6.d.ts)Β #10886; it and all the other copy-instantiating methods should return aPointbut instead returnnumber[]. I can't usedeclareto override the method signature directly because of Providedeclarekeyword support for class methodsΒ #38008 and Allow 'declare' on methods and constructorΒ #48290, and TS won't allow me to override it as a property because the types don't match. - What workarounds are you using in the meantime?
I'm removing the typing entirely by castingArrayto a dummy constructor ofObject:Previously I'd been casting it to a constructor ofexport class Point<Dims extends number = 2> extends (Array as new () => Object) implements PointLike<Dims> {
readonly number[], but that didn't work because, as mentioned above, I need to declaremap()as a method that returns a Point, and the existingnumber[]return signature can't be cast to a Point derived fromreadonly number[]. So now I'm casting it to Object, which comes with a fairly serious drawback: I can no longer use thesuperkeyword in my methods, because TS now thinks thatsuperis type Object, and I can't even correct it - thesuperkeyword can't have a type assertion applied to it, as mentioned in Allow type assertion for "super" keyword in method.Β #41034.
Now I go to write a lot of type assertions and // @ts-expect-error comments, because so far as I can tell, there is no other way around this.
Activity
dmchurch commentedon Mar 28, 2024
This is also possibly related to #4628. Not in the sense that my issue is affected by static inheritance, but because if this issue were resolved by the addition of something like the
extends privatemechanism described here, that could also be used to resolve 4628, by allowing decoupling of inherited members vs exposed members.dmchurch commentedon Mar 29, 2024
It occurs to me that one radical way to solve this problem would be to add some syntax that allows you to suppress creating the interface portion of the class altogether. Then you could simply define the interface separately with whatever subset of the actual functionality you want to expose, and then the ES6 class definition just gets matched against that interface, rather than generating the interface itself.
...Huh. This actually feels like a useful and actionable feature. You could rewrite the original example like this:
What do you think?
whzx5byb commentedon Apr 11, 2024
Danielle Church (@dmchurch) You can use a class expression to make it "private".
Note that you MUST NOT use the name
MyTuplefor the class expression. Use any other name or anonymous instead, otherwise the interfaceMyTuple<T>declared in the outer scope will be shadowed.dmchurch commentedon Apr 11, 2024
whzx5byb Yes, I've used that workaround before, and it's not applicable in this case. I need the emit to contain an ECMAScript top-level class export, which has slightly different semantics than an anonymous class assigned to a const (or a let, or a var, etc etc). If you have any suggestions that actually fit my needs, I'm all ears.
n1kk commentedon Apr 23, 2024
I was looking for something similar, I wanted my subclass to be a readonly array. After playing with all the possibilities I managed frankenstein this together from the bits an pieces on StackOverflow and this repos issues.
Playground
Kinda works. But couldn't make it an actual tuple though. Even casting the constructor factory to
readonly [number, number]did not limit the subclass to only 2 indexes. I guessextendsbroadens the type to have "at least two".Playground