> ## Documentation Index
> Fetch the complete documentation index at: https://e2e.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ページオブジェクト

> ひとつの画面のロケーターと操作をクラスにまとめ、フィクスチャとしてテストに渡します。

ページオブジェクトは、ひとつの画面のロケーターと操作を一か所にまとめるものです。テストでは同じ検索を繰り返し書かずに、そのメソッドを呼び出します。どのテストフレームワークでも使える設計パターンなので、Playwright や Selenium でページオブジェクトを書いたことがあれば、なじみのある形です。

e2e のページオブジェクトは、`screen` を受け取る通常の TypeScript クラスです。フィクスチャを通してテストに渡します。

## ページオブジェクトを作る

コンストラクターで `screen` を受け取り、ロケーターを作ります。ロケーターは遅延評価されるため、メソッドで使うまで要素の検索は行われません。

```ts title="tests/pages/sign-in-page.ts"

export class SignInPage {
  readonly email: Locator;
  readonly password: Locator;
  readonly submit: Locator;
  readonly error: Locator;

  constructor(readonly screen: Screen) {
    this.email = screen.getByLabel('Email');
    this.password = screen.getByLabel('Password');
    this.submit = screen.getByRole('button', 'Sign in');
    this.error = screen.getByRole('alert');
  }

  async signIn(email: string, password: string | Secret) {
    await this.email.fill(email);
    await this.password.fill(password);
    await this.submit.tap();
  }
}
```

ファイル名の末尾を `.e2e.ts` にしないでください。ランナーがテストとして収集してしまいます。

## フィクスチャとして渡す

`test.extend` のフィクスチャ内でページオブジェクトを作成します。この `test` をインポートするテストは、`beforeEach` を書かずに受け取れます。

```ts title="tests/fixtures.ts"

export const test = base.extend<{ signInPage: SignInPage }>({
  signInPage: async ({ screen }, use) => {
    await use(new SignInPage(screen));
  },
});
```

```ts title="tests/sign-in.e2e.ts"

test('rejects a wrong password', async ({ app, signInPage }) => {
  await app.open();
  await signInPage.signIn('ada@example.test', 'not-the-password');
  await expect(signInPage.error).toHaveText('Wrong email or password');
});
```

## 複数のプラットフォームで使えるようにする

`screen` だけを使うページオブジェクトは、Web とモバイルの両方のターゲットで動きます。`browser`（キーボード、CSS セレクター、`evaluate`）や `device` が必要な場合は、そのプラットフォームだけで動きます。

フィクスチャが `browser` または `device` を参照すると、その `test` の全テストがそれを必要とします。他のターゲットでは、`beforeEach` で `UNSUPPORTED_CAPABILITY` により失敗します。そこでスキップするには、テストに `requires: ['browser']` を指定します。または、プラットフォーム共通のテストには基本の `test` を使い続けてください。

## エージェントの目標を組み込む

メソッドの引数で `agent` を受け取り、アプリの変更が多い操作を目標として包めます。

```ts
async addCard(agent: Agent, name: string) {
  await agent.act('add a new card named {name}', { params: { name } });
}
```

フィクスチャ内で `agent` を参照しないでください。その `test` の全テストで、決定論的なテストも含めてモデルの設定が必要になってしまいます。

ページオブジェクトのメソッドには、フローに沿ってクリックするだけのものも多くあります。それらはひとつの [`agent.act` の目標](https://e2e.com/docs/ja/core-concepts#goals)で置き換えられます。全テストが繰り返し使い、厳密に実行する必要があるステップはメソッドとして残してください。

ログイン済みの状態でテストを始める場合、毎回 `signIn` を呼ぶ必要はありません。代わりに、セッションを一度保存します。[認証](https://e2e.com/docs/ja/authentication)を参照してください。

## 次のステップ

<CardGroup cols={2}>
  <Card title="認証" icon="key" href="/authentication">
    一度ログインしてセッションを再利用します。
  </Card>
  <Card title="テスト API" icon="code" href="/reference/test#your-own-fixtures">
    フィクスチャのセットアップ、後処理、実行順序を確認します。
  </Card>
</CardGroup>
