deprecates .email() etc

[https://v4.zod.dev/v4/changelog#zstring-updates]

元々z.string().email()のようにかけていたこれらは、z.email();と呼び出すように変更される。

現行のz.string().email()らに関しては、

The method forms (z.string().email()) still exist and work as before, but are now deprecated. They may be removed in a future version.

z.string().email()はまだ存在し、以前と同様に機能しますが、現在は非推奨です。将来のバージョンでは削除されるかもしれない。

とのことなので、先を見据えるのなら置き換えをしていく必要がありそう。

drops z.string().ip()

This has been replaced with separate .ipv4() and .ipv6() methods. Use z.union() to combine them if you need to accept both.

[https://v4.zod.dev/v4/changelog#drops-zstringip]

v4ではz.string().ip()は利用できなくなり、z.string().ipv4()もしくはz.string().ipv6()と明記する必要がある。

no longer extends Error

In Zod 4 the ZodError class no longer extends the plain JavaScript Error class. Any code that relies on instanceof Error will need to be refactored.

[https://v4.zod.dev/v4/changelog#no-longer-extends-error]

ZodErrorクラスはJavaScriptのErrorクラスを継承しなくなるため、v4以降のバージョンでは以下のようにガードする必要があるようだ。

1
try {
2
  z.string().parse(data)
3
} catch(err) {
4
  if (err instanceof Error) {
5
    // handle regular Error
6
  } else if (err instanceof z.ZodError) {
7
    // handle ZodError
8
  }
9
}

deprecates message

Replace message with error. The message parameter is still supported but deprecated.

https://v4.zod.dev/v4/changelog#deprecates-message

これまでカスタマイズエラーメッセージを設定する際は以下のように定義していた。

1
z.string().min(5, { message: "Too short." });

v4からはmessageはサポートは続くものの非推奨となり、errorとするように言われている。

1
z.string().min(5, { error: "Too short." });

がんばろう

他にも非推奨や削除されるものも多く、結構ぶっこんだ変更をしているのでがっつりZod使ってるところはかなり大変そうだ。