Cara memvalidasi email di Node.js tanpa menginstal paket

Integrasi Node.js: Rute pendaftaran ekspres

Berikut penangan rute Express lengkap yang memvalidasi email di POST /signup menggunakan pengambilan asli. Pola fail-open memastikan penghentian botoi tidak pernah memblokir pendaftaran sebenarnya:

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);

Rute menolak email yang tidak valid dengan 422 dan spesifiknya reason dari API. Jika API tidak dapat dijangkau, pendaftaran akan dilanjutkan. Anda menukarkan cek yang terlewat untuk aliran pengguna yang tidak terputus.

Validasi tiga lapis

Itu /v1/email/validate titik akhir mencakup dasar-dasarnya. Untuk pemeriksaan menyeluruh, gabungkan tiga titik akhir:

• /v1/email/validate untuk sintaks dan format
• /v1/email-mx/verify untuk verifikasi data MX
• /v1/disposable-email/check untuk deteksi sekali pakai

Fungsi pembantu ini memanggil ketiganya dan mengembalikan hasil terstruktur:

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;
}

Gunakan seperti ini:

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

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

Setiap lapisan menangkap kelas email buruk yang berbeda. Pemeriksaan format menghentikan input sampah. Pemeriksaan MX menghentikan domain yang ditemukan. Cek sekali pakai menghentikan pendaftaran sekali pakai. Bersama-sama, mereka menutupi celah yang dibiarkan terbuka oleh regex.

Menambahkan ke rute API Next.js

Logika yang sama berfungsi di pengendali rute Router Aplikasi Next.js di app/api/validate-email/route.ts. Versi ini menjalankan pemeriksaan format dan pemeriksaan sekali pakai secara paralel untuk memotong latensi:

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 });
  }
}

Hubungi rute ini dari formulir pendaftaran Anda onBlur handler untuk memvalidasi email sebelum pengguna mengirimkan. Paralel Promise.all menjaga waktu respons di bawah 200 ms untuk sebagian besar permintaan.

Menangani kasus tepi

Tiga pola membuat validator naif tersandung:

Domain penampung semua

Beberapa domain menerima email di alamat mana pun. anything@catch-all-domain.com tidak akan memantul, tapi kotak suratnya mungkin tidak ada. Pemeriksaan MX mengonfirmasi bahwa domain tersebut memiliki server email. Mengonfirmasi kotak surat tertentu memerlukan pengiriman email, yang sengaja dihindari oleh pendekatan ini. Untuk sebagian besar alur pendaftaran, verifikasi tingkat domain sudah cukup.

Alamat berbasis peran

Alamat seperti admin@, info@, Dan support@ adalah kotak masuk bersama. Aturan tersebut valid, namun merupakan kandidat yang buruk untuk kepemilikan akun karena tidak ada satu orang pun yang mengontrolnya. API menandainya dengan is_role: true. Anda dapat memperingatkan pengguna atau memblokir pendaftaran berdasarkan kebutuhan produk Anda.

Ditambah pengalamatan

user+tag@gmail.com mengirimkan ke user@gmail.com. Ini adalah fitur yang sah, bukan penyalahgunaan. Namun ini memungkinkan satu orang membuat banyak akun dengan kotak surat yang sama. Jika Anda ingin mencegah hal ini, lepaskan + akhiran sebelum validasi dan simpan alamat yang dinormalisasi.

Berikut fungsi yang menangani ketiganya:

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
// }

paket npm vs. pendekatan API

Pendekatan paket npm menempatkan logika validasi dan datanya (daftar domain, pola regex) di basis kode Anda. Anda memiliki pembaruannya. Saat penyedia sekali pakai baru diluncurkan, seseorang perlu membuka PR untuk menambahkannya. Pendekatan API membongkar pemeliharaan tersebut. Daftar domain memperbarui sisi server. Kode Anda tetap sama.

Imbalannya: API menambahkan ketergantungan jaringan. Pola fail-open yang ditunjukkan pada contoh Express dan Next.js menangani ini. Jika API tidak aktif, validasi lolos dan Anda mengandalkan perlindungan pendaftaran lainnya (konfirmasi email, pembatasan tarif) sampai API pulih.