Back to Blog

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

「Svelte Base」のお問い合わせフォームは、入力チェックに felte、送信先に SvelteKit の API ルート(+server.ts)を使っています。送信結果は Svelte 5 の $state で管理し、ページ遷移せずにその場で完了メッセージを出します。

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

felte でバリデーション

felte は use:form を付けるだけでフォームと連携できるライブラリです。validate でエラーのオブジェクトを返すと、$errors で参照できます。

const { form, errors, isSubmitting } = createForm<FormValues>({
  validate: (values) => {
    const errors: Partial<Record<keyof FormValues, string>> = {}
    if (!values.name?.trim()) errors.name = 'Name is required'
    if (!values.email?.trim()) errors.email = 'Email is required'
    else if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(values.email)) errors.email = 'Please enter a valid email'
    if (!values.message?.trim()) errors.message = 'Message is required'
    return errors
  },
  onSubmit: async (values) => { /* 後述 */ },
  onError: () => {
    // 最初のエラー項目へフォーカス
    queueMicrotask(() => document.querySelector<HTMLElement>('.form [aria-invalid="true"]')?.focus())
  }
})

onError で最初のエラー項目にフォーカスを移すと、キーボードで操作している人もどこを直せばいいかすぐ分かります。

送信状態は $state で

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

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

送信中は $isSubmitting でボタンを無効にし、二重送信を防いでいます。

API ルート

src/routes/api/contact/+server.ts に POST を書くと、それがエンドポイントになります。環境変数は実行時に読む $env/dynamic/private を使っているので、Vercel の設定を変えても再ビルドは不要です。

import { error, json } from '@sveltejs/kit'
import { env } from '$env/dynamic/private'

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 (env.RECAPTCHA_SECRET_KEY) {
    if (!googleReCaptchaToken || !(await verifyRecaptcha(env.RECAPTCHA_SECRET_KEY, googleReCaptchaToken))) {
      error(403, 'reCAPTCHA verification failed')
    }
  }
  // Nodemailer で送信
  return json({ ok: true })
}

Vercel へのデプロイ

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

// svelte.config.js
adapter: adapter({ runtime: 'nodejs24.x' })

まとめ

  • felte の onError で最初のエラーにフォーカスを移す
  • 送信結果は $state で持ち、その場でメッセージを出す
  • 実行時に変わる設定は $env/dynamic/private
  • Nodemailer を使う関数は Node.js ランタイムで動かす
04

Contact

お問い合わせ

Let's work together.

サイト制作・改修のご相談やご質問など、お気軽にお問い合わせください。通常2営業日以内にご返信します。

  • 返信目安:2営業日以内
  • reCAPTCHA で保護されています

This site is protected by reCAPTCHA and the Google
Privacy Policy and Terms of Service apply.

Thank you!

送信が完了しました。内容を確認のうえご連絡します。