高度な機能

条件タイプ

演算子

論理演算子

複数の条件を組み合わせることができます。

設定例

「プレミアムユーザーの検索リクエスト」のみをマッチングする場合:

URL Pattern: /api/search*
Method: GET

Conditions (AND):
  - Query Parameter "q" exists
  - Header "X-User-Type" equals "premium"

リクエストパススルー

リクエストをそのまま実サーバーに転送します。レスポンスはモックルールで設定した内容を返します。

レスポンスパススルー

実サーバーからのレスポンスをそのまま返します。モックルールは条件マッチングのみに使用します。

ステータスコード上書き

レスポンスパススルーを有効にした状態でステータスコード を指定すると、実サーバーのステータスコードを上書きできます。

# 実サーバーが 200 を返しても、500 に変更
レスポンスパススルー: ON
ステータスコード: 500

エラー処理のテストに便利です。

レスポンスボディマージ

JSON レスポンスの場合、実サーバーのレスポンスとモックのレスポンスをマージできます。

# 実サーバーのレスポンス
{
  "id": 1,
  "name": "John",
  "status": "active"
}

# モックで設定したボディ（Merge Response Body: ON）
{
  "status": "inactive",
  "debug": true
}

# 最終レスポンス
{
  "id": 1,
  "name": "John",
  "status": "inactive",
  "debug": true
}

遅延設定

各ルールの遅延 (ミリ秒) フィールドにミリ秒単位で遅延時間を設定します。

ユースケース

• ローディング状態テスト: ローディング UI が正しく表示されるかテスト

• タイムアウト処理テスト: タイムアウト処理が正しく動作するかテスト

• 低速ネットワークシミュレーション: 低速ネットワーク環境での動作確認

• 競合状態テスト: 複数リクエストの順序依存問題のテスト

対応フォーマット

主な機能

パス変換

OpenAPI のパスパラメータは、Mimicry のワイルドカードに自動変換されます。

# OpenAPI 定義
/users/{userId}/posts/{postId}

# Mimicry のパターンに変換
/users/*/posts/*

レスポンス生成

以下の優先順位でレスポンスボディを自動生成します。

使い方

1. 1

   サイドバーの OpenAPI インポート ボタンをクリック

2. 2

   OpenAPI 定義ファイル (YAML/JSON) を選択

3. 3

   プレビューでフォルダ・ルール構成を確認

4. 4

   インポート ボタンでモックルールを一括作成

設定項目

ユースケース

• ステージング認証トークンの付与: Authorization: Bearer xxx を常に注入し、毎回手動でセットする手間を省く

• デバッグヘッダーの付与: X-Debug-Token などをサーバー側のログ突合のために常時付与

設定例

ステージング環境の API すべてに認証トークンを付与する場合:

名前: Staging 認証トークン
対象ドメイン:
  *.staging.example.com
適用範囲: (未選択 → 全プロジェクト)
リクエストに追加・上書きするヘッダー:
  Authorization: Bearer eyJhbGciOi...
  X-Debug-Token: dev-local

利用できるプレースホルダ

レスポンスボディでの使用例

ID やタイムスタンプを毎回ユニークに返したい場合の例:

{
  "id": "{{uuid}}",
  "createdAt": "{{now}}",
  "expiresAt": "{{now+7d}}",
  "score": {{random_int(1,100)}},
  "status": "{{random_choice(active,pending,closed)}}"
}

フック

スクリプト内に以下の関数を定義すると、対応するタイミングで呼び出されます。

リクエスト/レスポンスオブジェクト

フックに渡されるオブジェクトは次の構造を持ちます。

// request
{
  url: string,        // 例: "https://api.example.com/items?id=1"
  method: string,     // "GET" / "POST" / ...
  headers: { [name: string]: string },
  body: string,       // テキスト or base64 (isBinary が true の場合)
  isBinary: boolean,
}

// response
{
  statusCode: number, // 例: 200
  headers: { [name: string]: string },
  body: string,
  isBinary: boolean,
}

スコープと有効化

• スコープ (URL パターン): モックルールと同じ書式で対象通信を絞り込みます (例: api.example.com/*)。
• 有効/無効: スクリプトごとにトグルで切り替え可能。無効化したスクリプトはマッチしても実行されません。
• console 出力: console.log/ warn/ error はスクリプトウインドウ下部のコンソールにリアルタイム表示されます。
• ドライラン: ダミーのリクエスト/レスポンスでスクリプトを試験実行できます。実トラフィックを流さずに、フックの挙動とログを確認可能です。

スクリプト例

リクエストヘッダーに署名を付与し、レスポンスボディの一部を書き換える例:

// スコープ: api.example.com/*

function onRequest(request) {
  // リクエストに署名を付与
  request.headers['X-Signature'] = 'sig-' + Date.now();
  console.log('signed:', request.url);
  return request;
}

function onResponse(request, response) {
  // JSON レスポンスの一部を上書き
  if ((response.headers['content-type'] || '').includes('application/json')) {
    try {
      const json = JSON.parse(response.body);
      json.debug = { injectedBy: 'mimicry-script' };
      response.body = JSON.stringify(json);
    } catch (e) {
      console.warn('JSON parse failed:', e.message);
    }
  }
  return response;
}

実行環境

スクリプトはサンドボックス上で実行され、外部リソース (ネットワーク・ファイルシステム) には直接アクセスできません。実行時間とメモリには上限が設定されており、リクエストごとに独立したコンテキストで評価されるため、スクリプト間や呼び出し間で状態は共有されません。