Classes
The reason why it's important to have classes in JavaScript as a first class item is that:
- Classes offer a useful structural abstraction
- Provides a consistent way for developers to use classes instead of every framework (emberjs,reactjs etc) coming up with their own version.
- Object Oriented Developers already understand classes.
Finally JavaScript developers can have class
. Here we have a basic class called Point:
class Point {
x: number;
y: number;
constructor(x: number, y: number) {
this.x = x;
this.y = y;
}
add(point: Point) {
return new Point(this.x + point.x, this.y + point.y);
}
}
var p1 = new Point(0, 10);
var p2 = new Point(10, 20);
var p3 = p1.add(p2); // {x:10,y:30}
This class generates the following JavaScript on ES5 emit:
var Point = (function () {
function Point(x, y) {
this.x = x;
this.y = y;
}
Point.prototype.add = function (point) {
return new Point(this.x + point.x, this.y + point.y);
};
return Point;
})();
This is a fairly idiomatic traditional JavaScript class pattern now as a first class language construct.
Inheritance
Classes in TypeScript (like other languages) support single inheritance using the extends
keyword as shown below:
class Point3D extends Point {
z: number;
constructor(x: number, y: number, z: number) {
super(x, y);
this.z = z;
}
add(point: Point3D) {
var point2D = super.add(point);
return new Point3D(point2D.x, point2D.y, this.z + point.z);
}
}
If you have a constructor in your class then you must call the parent constructor from your constructor (TypeScript will point this out to you). This ensures that the stuff that it needs to set on this
gets set. Followed by the call to super
you can add any additional stuff you want to do in your constructor (here we add another member z
).
Note that you override parent member functions easily (here we override add
) and still use the functionality of the super class in your members (using super.
syntax).
Statics
TypeScript classes support static
properties that are shared by all instances of the class. A natural place to put (and access) them is on the class itself and that is what TypeScript does:
class Something {
static instances = 0;
constructor() {
Something.instances++;
}
}
var s1 = new Something();
var s2 = new Something();
console.log(Something.instances); // 2
You can have static members as well as static functions.
Access Modifiers
TypeScript supports access modifiers public
,private
and protected
which determine the accessibility of a class
member as shown below:
accessible on | public |
protected |
private |
---|---|---|---|
class | yes | yes | yes |
class children | yes | yes | no |
class instances | yes | no | no |
If an access modifier is not specified it is implicitly public
as that matches the convenient nature of JavaScript 🌹.
Note that at runtime (in the generated JS) these have no significance but will give you compile time errors if you use them incorrectly. An example of each is shown below:
class FooBase {
public x: number;
private y: number;
protected z: number;
}
// EFFECT ON INSTANCES
var foo = new FooBase();
foo.x; // okay
foo.y; // ERROR : private
foo.z; // ERROR : protected
// EFFECT ON CHILD CLASSES
class FooChild extends FooBase {
constructor() {
super();
this.x; // okay
this.y; // ERROR: private
this.z; // okay
}
}
As always these modifiers work for both member properties and member functions.
Abstract
abstract
can be thought of as an access modifier. We present it separately because opposed to the previously mentioned modifiers it can be on a class
as well as any member of the class. Having an abstract
modifier primarily means that such functionality cannot be directly invoked and a child class must provide the functionality.
abstract
classes cannot be directly instantiated. Instead the user must create someclass
that inherits from theabstract class
.abstract
members cannot be directly accessed and a child class must provide the functionality.
Constructor is optional
The class does not need to have a constructor. e.g. the following is perfectly fine.
class Foo {}
var foo = new Foo();
Define using constructor
Having a member in a class and initializing it like below:
class Foo {
x: number;
constructor(x:number) {
this.x = x;
}
}
is such a common pattern that TypeScript provides a shorthand where you can prefix the member with an access modifier and it is automatically declared on the class and copied from the constructor. So the previous example can be re-written as (notice public x:number
):
class Foo {
constructor(public x:number) {
}
}
Property initializer
This is a nifty feature supported by TypeScript (from ES7 actually). You can initialize any member of the class outside the class constructor, useful to provide default (notice members = []
)
class Foo {
members = []; // Initialize directly
add(x) {
this.members.push(x);
}
}