SvelteKitのAPIルートでお問い合わせ送信:felte・reCAPTCHA・Nodemailer

「Svelte Base」のお問い合わせフォームは、入力チェックに felte、送信先に SvelteKit の API ルート(+server.ts)を使っています。送信結果は Svelte 5 の $state で管理し、ページ遷移せずにその場で完了メッセージを出します。SvelteKit 3 に上げたので、環境変数の読み方とアダプターの設定場所も新しい書き方に変えました。

リポジトリ:SvelteKit-TypeScript-MicroCMS-Site / デモ:https://sveltebase-phi.vercel.app/

felte でバリデーション

felte は use:form を付けるだけでフォームと連携できるライブラリです。validate でエラーのオブジェクトを返すと、$errors で参照できます。前後の空白だけの入力を通さないよう、trim() してから確認しています。

const { form, errors, isSubmitting } = createForm<FormValues>({
  validate: (values) => {
    const errors: Partial<Record<keyof FormValues, string>> = {};
    const name = values.name?.trim() ?? '';
    const email = values.email?.trim() ?? '';
    const message = values.message?.trim() ?? '';
    if (!name) errors.name = 'お名前を入力してください';
    if (!email) errors.email = 'メールアドレスを入力してください';
    else if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email))
      errors.email = 'メールアドレスの形式で入力してください';
    if (message.length < 10) errors.message = '10文字以上で入力してください';
    return errors;
  },
  onSubmit: async (values) => { /* 後述 */ }
});

エラーは各項目の下に出し、aria-invalid と aria-describedby で入力欄と結び付けています。aria-live="polite" を付けておくと、スクリーンリーダーにもエラーが読み上げられます。

<div class="field" class:is-invalid={$errors.name}>
  <input id="name" name="name" placeholder=" " autocomplete="name"
         aria-describedby="err-name" aria-invalid={!!$errors.name} required />
  <label for="name">お名前</label>
  <span class="field__err" id="err-name" aria-live="polite">{$errors.name ?? ''}</span>
</div>

最初のエラー項目へフォーカスする

送信ボタンを押したときにエラーがあれば、最初のエラー項目にフォーカスを移します。キーボードで操作している人も、どこを直せばいいかすぐ分かります。felte の検証結果が DOM に反映されてから探したいので、1 フレーム待ったうえで Svelte の tick() も待ちます。

<script lang="ts">
  import { tick } from 'svelte';

  let formEl = $state<HTMLFormElement>();
  const focusFirstError = async () => {
    await new Promise(requestAnimationFrame);
    await tick();
    formEl?.querySelector<HTMLElement>('[aria-invalid="true"]')?.focus();
  };
</script>

<form use:form novalidate bind:this={formEl} onsubmit={focusFirstError}>...</form>

送信状態は $state で

let sent = $state(false);
let failed = $state(false);

onSubmit: async (values) => {
  failed = false;
  try {
    values.googleReCaptchaToken = await getToken();
    const response = await fetch('/api/contact', {
      method: 'POST',
      body: JSON.stringify(values),
      headers: { 'Content-Type': 'application/json' }
    });
    if (response.ok) sent = true;
    else failed = true;
  } catch {
    failed = true;
  }
}

送信中は $isSubmitting でボタンを無効にし、ラベルも「送信中…」に変えて二重送信を防いでいます。sent が true になったら、フォームの代わりに完了メッセージを role="status" で出します。

{#if sent}
  <div class="form__done" role="status">
    <h3>Thank you!</h3>
    <p>送信が完了しました。内容を確認のうえ、メールでご連絡します。</p>
  </div>
{:else}
  <form ...>
    {#if failed}
      <p class="form__error" role="alert">送信に失敗しました。時間をおいて再度お試しください。</p>
    {/if}
    <button class="btn btn--dark" type="submit" disabled={$isSubmitting}>
      {$isSubmitting ? '送信中…' : '送信する'}
    </button>
  </form>
{/if}

環境変数は src/env.ts で宣言する

SvelteKit 3 では、使う環境変数を src/env.ts の defineEnvVars で宣言し、$app/env/private から読みます。以前のように $env/static/private と $env/dynamic/private を使い分ける必要はありません。

schema には値を確かめて変換する関数を書けます。空文字を「未設定」として扱ったり、ポート番号を数値にしたり、既定値を入れたりといった処理を 1 か所にまとめられます。値がおかしければアプリの起動(またはビルド)の時点でエラーになります。

// src/env.ts
import { defineEnvVars } from '@sveltejs/kit/env';

/** 空文字は未設定として扱う */
const optional = (value: string | undefined) => value || undefined;

export const variables = defineEnvVars({
  CONTACT_TO_EMAIL: { schema: optional },
  SMTP_HOST: { schema: (value) => value || 'smtp.gmail.com' },
  SMTP_PORT: {
    schema: (value) => {
      const port = Number(value || 465);
      if (!Number.isInteger(port)) throw new Error('SMTP_PORT must be an integer');
      return port;
    }
  },
  SMTP_USER: { schema: optional },
  SMTP_PASS: { schema: optional },
  RECAPTCHA_SECRET_KEY: {
    schema: optional,
    description: 'reCAPTCHA v3 secret key. When unset, verification is skipped.'
  }
});

SMTP_PORT は schema で数値に変換しているので、使う側では number 型として扱えます。

API ルート

src/routes/api/contact/+server.ts に POST を書くと、それがエンドポイントになります。ブラウザ側の入力チェックは送信前の案内にすぎないので、サーバー側でも必須項目とメールアドレスの形式を確かめます。

// src/routes/api/contact/+server.ts
import nodemailer from 'nodemailer';
import { error, json } from '@sveltejs/kit';
import {
  CONTACT_TO_EMAIL, RECAPTCHA_SECRET_KEY,
  SMTP_HOST, SMTP_PASS, SMTP_PORT, SMTP_USER
} from '$app/env/private';
import type { RequestHandler } from './$types';

export const POST: RequestHandler = async ({ request }) => {
  const { name, email, message, googleReCaptchaToken }: ContactBody = await request.json();

  if (!name || !email || !message) error(400, 'Missing required fields');
  if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) error(400, 'Invalid email');

  // シークレットキーが設定されている時だけ reCAPTCHA を確認する
  if (RECAPTCHA_SECRET_KEY) {
    if (!googleReCaptchaToken || !(await verifyRecaptcha(RECAPTCHA_SECRET_KEY, googleReCaptchaToken))) {
      error(403, 'reCAPTCHA verification failed');
    }
  }
  // Nodemailer で送信(後述)
  return json({ ok: true });
};

reCAPTCHA v3 はスコアと action も見る

reCAPTCHA v3 の検証 API は、人間らしさを 0.0〜1.0 の score で返します。success だけを見ると、スコアが低い送信も通ってしまいます。ここでは、送信時に指定した action が submit であることと、スコアが 0.5 以上であることも確認しています。

const verifyRecaptcha = async (secret: string, token: string) => {
  const res = await fetch('https://www.google.com/recaptcha/api/siteverify', {
    method: 'POST',
    body: new URLSearchParams({ secret, response: token })
  });
  const result: { success: boolean; score?: number; action?: string } = await res.json();
  const ok = result.success && result.action === 'submit' && (result.score ?? 0) >= 0.5;
  if (!ok) console.warn(`reCAPTCHA verification failed: ${JSON.stringify(result)}`);
  return ok;
};

Nodemailer で送信

返信ボタンで問い合わせた人に直接返せるよう、replyTo に入力されたメールアドレスを入れます。件名に改行が入るとメールのヘッダーが崩れるおそれがあるので、名前の改行は空白に置き換えています。送信に失敗したときは 500 を返し、フォーム側でエラーを表示します。

const transporter = nodemailer.createTransport({
  host: SMTP_HOST,
  port: SMTP_PORT,
  secure: SMTP_PORT === 465,
  auth: { user: SMTP_USER, pass: SMTP_PASS }
});

try {
  await transporter.sendMail({
    from: SMTP_USER,
    to: CONTACT_TO_EMAIL,
    replyTo: email,
    subject: `【Svelte Base】お問い合わせ: ${name.replace(/[\r\n]/g, ' ')}`,
    text: `お名前: ${name}\nメールアドレス: ${email}\n\nメッセージ:\n${message}`
  });
} catch (err) {
  console.error('Failed to send contact mail', err);
  error(500, 'Failed to send mail');
}

Vercel へのデプロイ

アダプターは @sveltejs/adapter-vercel で、ランタイムを nodejs24.x に指定しています。SvelteKit 3 では svelte.config.js ではなく、vite.config.ts の sveltekit() に書きます。Nodemailer は Node.js の API を使うので、Edge ランタイムでは動かない点に注意してください。

// vite.config.ts
import adapter from '@sveltejs/adapter-vercel';
import { sveltekit } from '@sveltejs/kit/vite';
import { defineConfig } from 'vite';

export default defineConfig({
  plugins: [sveltekit({ adapter: adapter({ runtime: 'nodejs24.x' }) })]
});

まとめ

  • 送信時に、最初のエラー項目へフォーカスを移す
  • 送信結果は $state で持ち、その場でメッセージを出す
  • 環境変数は src/env.ts で宣言し、既定値や型の変換も schema にまとめる
  • reCAPTCHA v3 は success だけでなく、スコアと action も確認する
  • Nodemailer を使う関数は Node.js ランタイムで動かす