TypeScriptのクラス

初級コースの『TypeScript入門』では、比較的シンプルなオブジェクトや配列を使う例を中心にTypeScriptの基礎を理解しました。 一方、実際のプロジェクトにおいてはより複雑で抽象的なデータやロジックを扱う場面にも少なくありません。

本コースでは中級編として、TypeScriptのクラスやジェネリクスといった、複雑で抽象化された型を扱うための技術を学びます。 ある程度TypeScriptに親しんでいる方であれば、入門を飛ばして本コースから学習をはじめても構いません。

基本のクラス

JavaScriptではES2015でクラス構文が導入されました。 TypeScriptでももちろんクラスを使うことができます。JavaScriptとの違いを中心に確認しましょう。

クラスの基本的な形は、型がついたこと以外JavaScriptのそれとほとんど変わりません。 次の例は座標を扱うPointクラスの例です。

class Point {
  /** X座標 */
  x: number;
  /** Y座標 */
  y: number;

  /** 新しい座標点を作成します */
  constructor(x = 0, y = 0) {
    this.x = x;
    this.y = y;
  }

  /** 原点からの距離 */
  get dist(): number {
    return Math.sqrt(this.x ** 2 + this.y ** 2);
  }

  /** 指定の座標を加算したあたらしい点を返します */
  add(p: Point): Point {
    return new Point(this.x + p.x, this.y + p.y);
  }
}

定義したクラスを利用するのも簡単です。 クラスの名前がそのまま型として使えることに注目してください。

const p: Point = new Point(1, 2);

JavaScriptでクラスを使ったことのある方であれば違和感なく使いこなせるはずです。

プロパティを読み取り専用にする

続けてTypeScriptのクラス特有の機能をみていきましょう。

オブジェクトのプロパティと同様、クラスのプロパティ(メンバー)もreadonlyを使って読み取り専用にできます。 readonlyなプロパティは、コンストラクターで初期化をする以外に値をセットすることができません。

class Point {
  /** X座標 */
  readonly x: number;
  /** Y座標 */
  readonly y: number;

  /** 新しい座標点を作成します */
  constructor(x = 0, y = 0) {
    this.x = x;
    this.y = y;
  }

  reset(): void {
    this.x = 0; // ❌エラー:readonlyなプロパティは変更できない
    this.y = 0; // ❌エラー:readonlyなプロパティは変更できない
  }
}

const p: Point = new Point(1, 2);
p.y = 3; // ❌エラー:外から変更するのももちろんNG

プロパティをプライベートにする

TypeScriptのクラスではアクセス修飾子を使ってプロパティの公開範囲をコントロールできます。 アクセス修飾子にはprivate, protected, publicの3種類があります。

private

privateを指定したプロパティやメソッドはクラスの内部からしかアクセスできなくなります。 次の例では、privateをつけたplayCountやresetはクラスの外からは参照すらできません。

class Cat {
  /** 遊んだ回数 */
  private playCount = 0;
  /** 遊んで「遊んだ回数」も更新する */
  play(): void {
    this.playCount++;
  }

  /** リセットします。このメソッドは外部からは呼べません */
  private reset(): void {
    this.playCount = 0;
  }
}

const tama = new Cat();
tama.play();
const count: number = tama.playCount; // ❌エラー:privateなプロパティにはアクセスできない
tama.reset(); // ❌エラー:privateなメソッドは呼べない

protected

privateはprivateに加えて、そのクラスを継承したクラスからもアクセスができることを示すキーワードです。 (JavaScriptでは馴染みのない概念ですが、JavaやC++等の継承を多用する言語では一般的です)

下の例では、先ほどのCatクラスを修正し、resetをprotectedに変更しました。サブクラスのSleepCatからはplayCountにはアクセスできませんが、resetを呼び出すことはできます。

class Cat {
  /** 遊んだ回数 */
  private playCount = 0;
  /** 遊んで「遊んだ回数」も更新する */
  play(): void {
    this.playCount++;
  }

  /** リセットします。このメソッドは外部からは呼べません */
  protected reset(): void {
    this.playCount = 0;
  }
}

class SleepCat extends Cat {
  /** 寝ると遊んだ回数もリセットされます */
  sleep(): void {
    this.playCount = 0; // ❌エラー:privateなメンバーにはサブクラスからでもアクセスできない
    this.reset(); // ⭕️OK:resetはprotectedなのでサブクラスからアクセスできる
  }
}

public

publicはデフォルトのアクセス修飾子です。publicを明記するか、あるいは単にプロパティの名前だけを書いた場合、そのプロパティはどこからでも自由にアクセスできます。

複数の修飾子を組み合わせる

このレッスンで学んだreadonlyやprivateと言った修飾子はJavaScript標準のものと組み合わせて使うことができます。 次の例ではいくつもの修飾子が併記されています。これらはすべて有効な指定です。

class Point {
  static readonly ORIGIN: Point = new Point(0, 0);
  private static readonly PI = 3.14159265;
  protected readonly x: number;
  protected readonly y: number;

  constructor(x: number, y: number) {
    this.x = x;
    this.y = y;
  }
}

まとめ

このレッスンではTypeScriptでクラスを使う基本的な記法を確認しました。 JavaScriptでクラスの書き方に馴染んでいる方であれば難しい内容ではなかったはずです。 馴染みのない書き方だと思われた場合は、この機会にJavaScriptの現代的な書き方も学習してみましょう。