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 ランタイムで動かす
Have a project in mind or a question about this post?