トラブルシューティング
よくある症状の原因と直し方です。エラー文で探すときは、ページの中を検索してください。
このページの内容
fields must tolerate absence
原因
スキーマのフィールドに.default()も.optional()も付いていません。URLのパラメータやストレージの値はいつでも欠けうるので、定義はモジュールの読み込みの時点でエラーになります。
直し方
エラーに挙がったフィールドに、.default()か.optional()を付けます。zod/miniならz._default()かz.optional()です。エラー文がrejects its own defaultsなら、オブジェクト全体の.refine()がすべて既定値の状態を受け付けるようにします。
url boolean fields must use z.stringbool()
原因
urlのフィールドか配列の要素に、z.boolean()かz.coerce.boolean()を書いています。どちらもURLの"false"をfalseとして読めないので、定義はモジュールの読み込みの時点でエラーになります。
直し方
z.stringbool()に書き換えます。
url array fields must default to []
原因
urlの配列が.optional()か、[]以外の既定値を持っています。パラメータの無いURLと、空の配列を書いたURLは同じです。既定値が[]でないと、空の配列を書けません。
直し方
.default([])にします。
Server Componentで呼べないhref
原因
定義を'use client'のファイルからexportしています。Server Componentには定義の代わりにclient referenceが渡るので、hrefやparseUrlを呼べません。
直し方
定義を'use client'の無いモジュールに移します。定義は純粋なので、サーバーとクライアントのどちらからもimportできます。
has no URL serialization
原因
urlのフィールドに、DateのようにURLで表せない値を書いています。
直し方
URLに置けるのは文字列と数値と真偽値、およびそれらの配列だけです。日付は文字列で持ちます。
update()でのページ全体の再読み込み
原因
ルーターがnavigateイベントをintercept()していません。今のNext.jsがそうで、navigation.navigate()はページ全体の読み込みになります。
直し方
そのルーターでは、URLの変更をリンクとGETフォームで行います。@k8ordo/frameworkは@k8ordo/routerの上で動くので、ページ全体の読み込みにはなりません。
書くたびに既定値に戻る真偽値
原因
entryやWeb Storage、Cookieのスキーマにz.stringbool()を書いています。これらの置き場所では、書いたtrueが真偽値のままスキーマに渡ります。z.stringbool()は文字列しか受け付けないので、そのtrueを拒み、フィールドは既定値に戻ります。
直し方
z.boolean()に書き換えます。urlからentryへ移したフィールドも、同じように書き換えます。
再読み込みで既定値に戻る日付
原因
Web StorageとCookieの値はJSONで保存されます。読み戻したDateは文字列になり、z.date()はその文字列を拒みます。フィールドは既定値に戻ります。update()はJSONを経由せずに値を反映するため、書いた直後だけDateのまま表示されます。
直し方
フィールドをJSONで表せる型にします。日付は文字列で持ちます。
同じ値になる2つの状態
原因
同じ種類の定義に同じキーを付けています。同じキーの定義は1つのストアを共有します。@k8ordo/color-schemeも、color-schemeというキーでlocalStorageの状態を定義しています。
直し方
キーを、アプリの中で重ならない名前に変えます。キーを変えると保存した値の名前も変わるので、古いキーの値は読まれなくなります。
Safariで消えるCookie
原因
Cookie Store APIはCookieに必ずSecureを付けます。Safariはhttp://localhostでもSecureのCookieを捨てます。
直し方
開発中もHTTPSで配信します。
テストをまたいで残る値
原因
ストアはモジュールの中の登録表に残り、保存した値もブラウザに残ります。
直し方
コンポーネントをアンマウントしてからresetStateRegistry()を呼びます。そのうえで、storageKeyやcookieNameで保存した値を消します。
テスト中のページ移動
原因
navigateイベントをintercept()するものが無いので、navigation.navigate()がページ全体の読み込みになります。
直し方
ルーターの代わりに、テストの中でnavigateイベントを受け取ってevent.intercept()を呼びます。