# インターフェース

## インターフェース(Interfaces)

インターフェースは、JavaScriptランタイム上では、何の影響もありません。TypeScriptのインターフェースは、オブジェクトの構造を宣言するための多くの機能があります。

次の2つは同じ意味の宣言です。１つ目は、インラインの型定義を使用し、2つ目はインターフェースを使用しています。

```typescript
// Sample A
declare var myPoint: { x: number; y: number; };

// Sample B
interface Point {
    x: number; y: number;
}
declare var myPoint: Point;
```

しかし、\_サンプル B\_の美しいところは、`myPoint` このライブラリを使って、別のライブラリを作る誰かが、新しいプロパティを追加する際に、簡単に`myPoint`の宣言を拡張して、新しいプロパティを追加できることです：

```typescript
// Lib a.d.ts
interface Point {
    x: number; y: number;
}
declare var myPoint: Point;

// Lib b.d.ts
interface Point {
    z: number;
}

// Your code
var myPoint.z; // Allowed!
```

これは、TypeScriptの**インターフェースが拡張に対してオープン**であるためです。これはTypeScriptの重要な教えです。\_インターフェース\_は、JavaScriptの拡張性と同じことを実現しています。

## クラスはインターフェースを実装できる

誰かがあなたのために`interface`で宣言したオブジェクト構造に従わなければならない\_クラス\_を使いたい場合、互換性を保証するために`implements`キーワードを使うことができます：

```typescript
interface Point {
    x: number; y: number;
}

class MyPoint implements Point {
    x: number; y: number; // Same as Point
}
```

基本的に`implements`したクラスがあるときに、その外部の`Point`インターフェースを変更すると、あなたのコードベースでコンパイルエラーになりますので、簡単に同期を取ることができます：

```typescript
interface Point {
    x: number; y: number;
    z: number; // New member
}

class MyPoint implements Point { // ERROR : missing member `z`
    x: number; y: number;
}
```

`implements`はクラスの\_インスタンス\_の構造を制限することに注意してください。

```typescript
var foo: Point = new MyPoint();
```

`foo：Point = MyPoint`のようなものは上記とは異なります。

## ヒント

### すべてのインターフェースが簡単に実装できるとは限りません

インターフェースは、JavaScriptで可能などんな変な構造でも宣言できるように設計されています。

`new`をコールできる何かのインターフェースを考えてみましょう：

```typescript
interface Crazy {
    new (): {
        hello: number
    };
}
```

基本的な実装は次のようなものです：

```typescript
class CrazyClass implements Crazy {
    constructor() {
        return { hello: 123 };
    }
}
// Because
const crazy = new CrazyClass(); // crazy would be {hello:123}
```

インターフェースを使って変な構造を宣言し、TypeScriptの型のサポートを得つつ、安全に使用することもできます。しかし、それらをTypeScriptのクラスとして実装できるとは限りません。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://typescript-jp.gitbook.io/deep-dive/type-system/interfaces.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.