2026/03/28

タグベースアドレスでAPI呼び出しなしにテスト用メールアドレスを生成する

タグベースアドレステストAPI

タグベースアドレスとは

MailBrewのタグベースアドレスは、{任意の文字列}@{会社名}.mailbrew.dev の形式でメールを受信できる機能です。

[email protected]
[email protected]
[email protected]

これらのアドレスは事前にAPIで作成する必要がありません。メールを送信するだけで自動的にMailBrewに届きます。

従来のアプローチとの違い

従来: APIでアドレスを作成

// 1. APIを呼んでアドレスを作成（ネットワーク遅延あり）
const addr = await mb.addresses.create({ ttl: 300 });

// 2. 作成したアドレスを使用
await page.fill('[name="email"]', addr.address);

タグベース: 即座に使用

// UUIDを生成してそのまま使える（API呼び出し不要）
const addr = `test-${crypto.randomUUID()}@acme.mailbrew.dev`;
await page.fill('[name="email"]', addr);

メリット

  1. ゼロレイテンシ — API呼び出しがないため、アドレス生成は即座
  2. レート制限なし — APIを使わないので、レート制限に引っかからない
  3. テストの並列実行に最適 — UUIDを使えば衝突の心配なし
  4. シンプル — SDKのインポートすら不要

活用パターン

パターン1: テストケースごとのアドレス

test('サインアップフロー', async ({ page }) => {
  const email = `signup-${Date.now()}@acme.mailbrew.dev`;
  // ...
});

パターン2: サービスごとのアドレス

マイクロサービス環境で、サービスごとにプレフィックスを分ける:

auth-service-{id}@acme.mailbrew.dev
billing-{id}@acme.mailbrew.dev
notification-{id}@acme.mailbrew.dev

パターン3: 多言語テスト

const locales = ['ja', 'en', 'zh'];
for (const locale of locales) {
  const email = `lang-test-${locale}@acme.mailbrew.dev`;
  await testSignupFlow(email, locale);
}

メール取得

タグベースアドレスに届いたメールは、通常のAPIで取得できます:

const emails = await mb.addresses.waitForEmail(
  `[email protected]`,
  { timeout: 30 }
);

カスタムドメインとの組み合わせ

Proプラン以上では、カスタムドメインとタグベースアドレスを組み合わせられます:

test-{id}@mail.your-company.com

自社ドメインのメールアドレスでテストできるため、ドメインベースのバリデーションがあるアプリケーションのテストにも対応できます。

まとめ

タグベースアドレスは、テスト用メールアドレスの生成をゼロコストにします。特にE2Eテストの並列実行やCI環境での使用に最適です。

今すぐ試す →

← ブログ一覧
© 2026 MailBrew