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

> Actions Code Editor または Management API でサンプルペイロードを実行し、テナントログでエンドツーエンドのフローを検証し、モックイベントおよび API オブジェクトを使用してハンドラーコードのユニットテストを完了することで、Auth0 Actions をテストおよびデバッグします。

# Actions をテストする

Auth0 Actions のテストやデバッグには、実装の進み具合に応じていくつかの方法があります。

各Actionは、実装しながら <Tooltip tip="Auth0 Dashboard: サービスを設定するための Auth0 の主要製品。" cta="用語集を見る" href="/docs/ja-jp/glossary?term=Auth0+Dashboard">Auth0 Dashboard</Tooltip> から個別にテストすることをおすすめします。準備ができたら、Auth0 Dashboard でテナントログを使って、エンドツーエンドのフローが想定どおりに動作することを確認してください。

<div id="test-individual-actions">
  ## 個別の Action をテストする
</div>

Actions Code Editor を使うと、個々の Action をテストできます。エディタのテスト機能では、Action に関連付けられたフローに基づくサンプルのペイロードを使用して、Action の呼び出しをシミュレートできます。個別の Action をテストするには、次の手順に従います。

1. [Auth0 Dashboard > Actions](https://manage.auth0.com/#/actions) に移動し、編集するフローと Action を選択します。
2. Actions Code Editor を開き、サイドバーから **Test** (再生アイコン) を選択します。Test サイドバーでペイロードを編集すると、異なるペイロードでの結果を確認できます。
3. **Run** を選択します。

テスト結果には、Action が実行したステップ、コンソール出力、発生したエラー、および Action の実行に関する役立つ統計情報が表示されます。

<Frame>
  <img src="https://mintcdn.com/translations/c0RQ9V0YAcT0-8l5/docs/images/cdy7uua7fh8z/7I4CRM8SmRFiibjuk55L86/794042f525cddd55a8005cc646b3c9c2/test-action-code-editor.png?fit=max&auto=format&n=c0RQ9V0YAcT0-8l5&q=85&s=4127ea180888640c25044fc5c03f83c1" alt="Action Code Editor 内のテストモジュールのスクリーンショット" width="894" height="473" data-path="docs/images/cdy7uua7fh8z/7I4CRM8SmRFiibjuk55L86/794042f525cddd55a8005cc646b3c9c2/test-action-code-editor.png" />
</Frame>

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Management API の [**Test an Action** endpoint](https://auth0.com/docs/api/management/v2#!/Actions/post_test_action) を使用し、Action に関連付けられているフローに対応するペイロードを指定して Action をテストすることもできます。サンプルのペイロードを取得するには、Actions Code Editor の Test 機能で Action をテストしてください。
</Callout>

<div id="debug-deployed-actions">
  ## デプロイ済みの Actions をデバッグする
</div>

Action のテストが完了したら、次はそれをデプロイして実際の実行状況を確認します。Action をすでにデプロイし、フローに追加している場合 (Actions を フロー に追加する方法については、[Write Your First Action](/docs/ja-jp/customize/actions/write-your-first-action) の「Attach the Action to a flow」セクションを参照してください) 、いくつかの手順で実行中の Action をデバッグできます。

<div id="verify-end-to-end-login-flow">
  ### エンドツーエンドのログインフローを検証する
</div>

`post-login` Action の場合は、テナントでログインを試すことで、エンドツーエンドのログインフローを検証できます。

1. [Auth0 Dashboard > Authentication > Authentication Profile](https://manage.auth0.com/#/authentication-profiles) に移動し、**Try** を選択します。サンプルログインを含むウィンドウが開きます。
2. ログインフローを進めます。設定済みの Action は、このログインフローの中ですべて実行されます。

完了すると、アプリケーションが受け取るユーザープロファイル属性の一覧が表示されるページ、または問題の内容を説明するエラーメッセージが表示されるページにリダイレクトされます。

<div id="analyze-tenant-logs">
  ### テナントログを分析する
</div>

フローに関連付けられた Action がバインドされたトリガーが実行されるたびに、[テナントログ](/docs/ja-jp/deploy-monitor/logs/view-log-events) に Action の実行詳細が記録されます。

テナントログの一覧では、Actions に関連するログを確認して表示できます。以下の例では、`Success Login` というログタイプが、このテナントの `post-login` トリガー上の Action に関連付けられています。

<Frame>
  <img src="https://mintcdn.com/translations/pvjQqAy3EB2TK6NP/docs/images/cdy7uua7fh8z/4hIo2YJ8fr2tfMEWhaLyn4/7935eec2f5a59c0191cbf24eaccf044d/2025-01-31_14-30-57.png?fit=max&auto=format&n=pvjQqAy3EB2TK6NP&q=85&s=4d9043d4c0c4bf373ca0941cbca3197f" alt="Action の実行に関連するログを表示した Auth0 Dashboard のテナントログ一覧のスクリーンショット。" width="1529" height="758" data-path="docs/images/cdy7uua7fh8z/4hIo2YJ8fr2tfMEWhaLyn4/7935eec2f5a59c0191cbf24eaccf044d/2025-01-31_14-30-57.png" />
</Frame>

Actions に関連するログタイプには、次のようなものがあります。

| Name                    | Trigger(s)                                                                                                                      |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Success Login           | [post-login](/docs/ja-jp/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger)                            |
| Failed Login            | [post-login](/docs/ja-jp/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger)                            |
| Success Exchange        | [post-login](/docs/ja-jp/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger)                            |
| Failed Exchange         | [post-login](/docs/ja-jp/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger)                            |
| Success Change Password | [post-change-password](/docs/ja-jp/customize/actions/explore-triggers/password-reset-triggers/post-change-password-trigger)     |
| Failed Change Password  | [post-change-password](/docs/ja-jp/customize/actions/explore-triggers/password-reset-triggers/post-change-password-trigger)     |
| Successful Signup       | [pre-user-registration](/docs/ja-jp/customize/actions/explore-triggers/signup-and-login-triggers/pre-user-registration-trigger) |
| Failed Signup           | [pre-user-registration](/docs/ja-jp/customize/actions/explore-triggers/signup-and-login-triggers/pre-user-registration-trigger) |
| Success Exchange        | [credentials-exchange](/docs/ja-jp/customize/actions/explore-triggers/machine-to-machine-trigger)                               |
| Failed Exchange         | [credentials-exchange](/docs/ja-jp/customize/actions/explore-triggers/machine-to-machine-trigger)                               |

Action の実行に関する詳細情報を表示するには、Action の実行に関連するログを選択し、**Action Details** ビューを開きます。Action Details では、実行統計、コンソール出力、発生したエラーを確認できます。

<Frame>
  <img src="https://mintcdn.com/translations/eVsQcTnbClN-oB7d/docs/images/cdy7uua7fh8z/1WrsQvjZxI2WRMrtltandy/0bc92038a5bc7b6344a95ef271eff299/actions-log-detail.png?fit=max&auto=format&n=eVsQcTnbClN-oB7d&q=85&s=f5f466125ec65157dd222594d8ce53b0" alt="Actions のテストに関連する個別ログのスクリーンショット。" width="1042" height="794" data-path="docs/images/cdy7uua7fh8z/1WrsQvjZxI2WRMrtltandy/0bc92038a5bc7b6344a95ef271eff299/actions-log-detail.png" />
</Frame>

<div id="unit-test-actions">
  ## Actions の単体テスト
</div>

​Action 関数に渡される event と api をモックすることで、Auth0 Actions の単体テストを行えます。Actions はバージョン管理システムやローカルディレクトリで管理でき、Jest のようなツールを使えば自動的にテストできます。次の例では、[Login / Post Login](/docs/ja-jp/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger) トリガーと [Jest](https://jestjs.io/) を使ってモックとテストを行います。

**Action コード:**

```javascript lines theme={null}
// action.js

exports.onExecutePostLogin = async (event, api) => {
  const namespace = "https://my-app.example.com";
  if (event.authorization) {
    api.idToken.setCustomClaim(`${namespace}/favorite_color`, "pink");
  }
};
```

**テストファイルのコード:**

```javascript lines theme={null}
// action.spec.js

const { onExecutePostLogin } = require("./action.js");
test("sets favorite_color ID token claim to pink", async () => {
  const namespace = "https://my-app.example.com";
  const mockFunction = jest.fn();
  const mockApi = { idToken: { setCustomClaim: mockFunction } };
  const mockEvent = {authorization: {}};

  await onExecutePostLogin(mockEvent, mockApi);
  expect(mockFunction).toBeCalledWith(
    `${namespace}/favorite_color`,
    "pink"
  );
});
```

<div id="best-practices">
  ## ベストプラクティス
</div>

Auth0 で Actions を構築する際は、[環境ごとに専用の Auth0 テナントを作成することを推奨します](/docs/ja-jp/get-started/auth0-overview/create-tenants/set-up-multiple-environments)。これにより、本番環境のユーザー基盤を他の環境から分離できるほか、環境ごとに異なる管理者を設定できます (たとえば、エンジニアには本番環境の設定へのアクセスを許可しないようにできます) 。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  CLI や CI/CD パイプラインを使って Actions を完全に管理、テスト、デプロイしたい場合は、[Deploy CLI Tool](/docs/ja-jp/deploy-monitor/deploy-cli-tool) を使用できます。
</Callout>