パッケージをインストールせずに Node.js でメールを検証する方法

Node.js 統合: 高速サインアップ ルート

これは、POST で電子メールを検証する完全な Express ルート ハンドラーです。 /signup ネイティブフェッチを使用します。 フェールオープン パターンにより、botoi の停止によって実際のサインアップがブロックされることがなくなります。

import express from 'express';

const app = express();
app.use(express.json());

app.post('/signup', async (req, res) => {
  const { email, password } = req.body;

  if (!email || !password) {
    return res.status(400).json({ error: 'Email and password are required' });
  }

  // Validate email before creating the account
  try {
    const validation = await fetch('https://api.botoi.com/v1/email/validate', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': \`Bearer \${process.env.BOTOI_API_KEY}\`,
      },
      body: JSON.stringify({ email }),
      signal: AbortSignal.timeout(3000),
    });

    const result = await validation.json();

    if (result.success && !result.data.is_valid) {
      return res.status(422).json({
        error: 'Invalid email address',
        reason: result.data.reason,
      });
    }
  } catch {
    // Fail open: if the API is unreachable, let the signup proceed
    console.warn('Email validation API unreachable, skipping check');
  }

  // Email passed validation; continue with account creation
  // await createUser(email, password);

  return res.status(201).json({ message: 'Account created' });
});

app.listen(3000);

ルートは、422 および特定のメールを含む無効な電子メールを拒否します。 reason APIから。 API にアクセスできない場合は、サインアップが続行されます。 小切手を逃した代わりに、中断されないユーザー フローを得ることができます。

3層検証

の /v1/email/validate エンドポイントは基本をカバーします。 徹底的にチェックするには、次の 3 つのエンドポイントを組み合わせます。

• /v1/email/validate 構文と形式については
• /v1/email-mx/verify MX レコード検証用
• /v1/disposable-email/check 使い捨て検出用

このヘルパー関数は 3 つすべてを呼び出し、構造化された結果を返します。

interface ValidationResult {
  valid: boolean;
  formatValid: boolean;
  mxValid: boolean;
  isDisposable: boolean;
  reason: string | null;
}

const API_BASE = 'https://api.botoi.com/v1';
const headers = {
  'Content-Type': 'application/json',
  'Authorization': \`Bearer \${process.env.BOTOI_API_KEY}\`,
};

async function validateEmail(email: string): Promise<ValidationResult> {
  const result: ValidationResult = {
    valid: true,
    formatValid: false,
    mxValid: false,
    isDisposable: false,
    reason: null,
  };

  // Layer 1: Syntax and format check
  const formatRes = await fetch(\`\${API_BASE}/email/validate\`, {
    method: 'POST',
    headers,
    body: JSON.stringify({ email }),
    signal: AbortSignal.timeout(3000),
  });
  const formatData = await formatRes.json();

  if (!formatData.success || !formatData.data.format_valid) {
    return { ...result, valid: false, reason: 'invalid_format' };
  }
  result.formatValid = true;

  // Layer 2: MX record verification
  const mxRes = await fetch(\`\${API_BASE}/email-mx/verify\`, {
    method: 'POST',
    headers,
    body: JSON.stringify({ email }),
    signal: AbortSignal.timeout(3000),
  });
  const mxData = await mxRes.json();

  if (!mxData.success || !mxData.data.has_mx) {
    return { ...result, valid: false, reason: 'no_mx_records' };
  }
  result.mxValid = true;

  // Layer 3: Disposable provider detection
  const dispRes = await fetch(\`\${API_BASE}/disposable-email/check\`, {
    method: 'POST',
    headers,
    body: JSON.stringify({ email }),
    signal: AbortSignal.timeout(3000),
  });
  const dispData = await dispRes.json();

  if (dispData.success && dispData.data.is_disposable) {
    return { ...result, valid: false, isDisposable: true, reason: 'disposable_provider' };
  }

  return result;
}

次のように使用します。

const result = await validateEmail('user@tempmail.xyz');

if (!result.valid) {
  console.log(\`Rejected: \${result.reason}\`);
  // Rejected: disposable_provider
}

各層は、異なるクラスの不正メールを捕捉します。 フォーマットチェックにより、ガベージ入力が停止されます。 MX チェックは、発明されたドメインを停止します。 使い捨て小切手により、使い捨てのサインアップがなくなります。 これらを組み合わせることで、正規表現によって生じるギャップをカバーします。

Next.js API ルートへの追加

同じロジックが、次の Next.js App Router ルート ハンドラーでも機能します。 app/api/validate-email/route.ts。 このバージョンでは、フォーマット チェックと使い捨てチェックを並行して実行して、レイテンシを短縮します。

import { NextResponse } from 'next/server';

const API_BASE = 'https://api.botoi.com/v1';
const headers = {
  'Content-Type': 'application/json',
  'Authorization': \`Bearer \${process.env.BOTOI_API_KEY}\`,
};

export async function POST(req: Request) {
  const body = await req.json();
  const email = body.email?.trim().toLowerCase();

  if (!email) {
    return NextResponse.json(
      { error: 'Email is required' },
      { status: 400 }
    );
  }

  try {
    // Run format check and disposable check in parallel
    const [formatRes, dispRes] = await Promise.all([
      fetch(\`\${API_BASE}/email/validate\`, {
        method: 'POST',
        headers,
        body: JSON.stringify({ email }),
        signal: AbortSignal.timeout(3000),
      }),
      fetch(\`\${API_BASE}/disposable-email/check\`, {
        method: 'POST',
        headers,
        body: JSON.stringify({ email }),
        signal: AbortSignal.timeout(3000),
      }),
    ]);

    const [formatData, dispData] = await Promise.all([
      formatRes.json(),
      dispRes.json(),
    ]);

    if (formatData.success && !formatData.data.format_valid) {
      return NextResponse.json(
        { valid: false, reason: 'Invalid email format' },
        { status: 422 }
      );
    }

    if (dispData.success && dispData.data.is_disposable) {
      return NextResponse.json(
        { valid: false, reason: 'Disposable emails are not allowed' },
        { status: 422 }
      );
    }

    // Then check MX records
    const mxRes = await fetch(\`\${API_BASE}/email-mx/verify\`, {
      method: 'POST',
      headers,
      body: JSON.stringify({ email }),
      signal: AbortSignal.timeout(3000),
    });
    const mxData = await mxRes.json();

    if (mxData.success && !mxData.data.has_mx) {
      return NextResponse.json(
        { valid: false, reason: 'Email domain has no mail server' },
        { status: 422 }
      );
    }

    return NextResponse.json({ valid: true });
  } catch {
    // Fail open on API errors
    return NextResponse.json({ valid: true });
  }
}

サインアップフォームからこのルートを呼び出します onBlur ユーザーが送信する前に電子メールを検証するハンドラー。 パラレル Promise.all ほとんどのリクエストの応答時間を 200 ミリ秒未満に保ちます。

特殊なケースの処理

素朴なバリデーターにつまずく 3 つのパターン:

キャッチオール ドメイン

一部のドメインでは、任意のアドレスの電子メールを受け入れます。 anything@catch-all-domain.com 弾まないし、 ただし、メールボックスが存在しない可能性があります。 MX チェックにより、ドメインにメール サーバーがあることが確認されます。 特定のメールボックスを確認するには電子メールを送信する必要がありますが、このアプローチでは意図的に回避されています。 ほとんどのサインアップ フローでは、ドメイン レベルの検証で十分です。

役割ベースのアドレス

のようなアドレス admin@、 info@、 そして support@ 共有受信箱です。 これらは有効ですが、単一の人物が管理していないため、アカウントの所有権の候補としては適していません。 API はこれらにフラグを付けます。 is_role: true。 製品のニーズに基づいて、ユーザーに警告したり、サインアップをブロックしたりできます。

プラスアドレス指定

user+tag@gmail.com に配達します user@gmail.com。 これは正当な機能であり、悪用ではありません。 ただし、1 人が同じメールボックスで多数のアカウントを作成できるようになります。 これを防ぎたい場合は、 + 検証の前にサフィックスを追加し、正規化されたアドレスを保存します。

3 つすべてを処理する関数は次のとおりです。

async function validateEmailStrict(email: string): Promise<{
  valid: boolean;
  warnings: string[];
  reason: string | null;
}> {
  const warnings: string[] = [];

  // Check for plus addressing (user+tag@gmail.com)
  const localPart = email.split('@')[0];
  if (localPart.includes('+')) {
    warnings.push('plus_addressing');
  }

  const res = await fetch('https://api.botoi.com/v1/email/validate', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': \`Bearer \${process.env.BOTOI_API_KEY}\`,
    },
    body: JSON.stringify({ email }),
    signal: AbortSignal.timeout(3000),
  });

  const data = await res.json();

  if (!data.success) {
    return { valid: false, warnings, reason: 'api_error' };
  }

  // Flag role-based addresses (admin@, info@, support@)
  if (data.data.is_role) {
    warnings.push('role_based_address');
  }

  // Reject disposable providers
  if (data.data.is_disposable) {
    return { valid: false, warnings, reason: 'disposable_provider' };
  }

  // Reject domains with no MX records
  if (!data.data.is_valid && data.data.reason === 'no_mx_records') {
    return { valid: false, warnings, reason: 'no_mx_records' };
  }

  return { valid: data.data.is_valid, warnings, reason: null };
}

const result = await validateEmailStrict('admin+test@example.com');
// {
//   valid: true,
//   warnings: ['plus_addressing', 'role_based_address'],
//   reason: null
// }

npm パッケージと API のアプローチ

npm パッケージのアプローチでは、検証ロジックとそのデータ (ドメイン リスト、正規表現パターン) をコードベースに配置します。 アップデートの所有者はあなたです。 新しい使い捨てプロバイダーが起動すると、誰かが PR を開いてそれを追加する必要があります。 API アプローチにより、そのメンテナンスの負荷が軽減されます。 ドメインリストはサーバー側で更新されます。 コードは変わりません。

トレードオフ: API によりネットワーク依存性が追加されます。 Express および Next.js の例に示されているフェールオープン パターン がこれを処理します。 API がダウンしている場合、検証はパスし、他のサインアップ保護 (メール確認、レート制限) に依存します。 API が回復するまで。