@k8ordo/state

トラブルシューティング

よくある症状の原因と直し方です。エラー文で探すときは、ページの中を検索してください。

このページの内容

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の状態を定義しています。

直し方

キーを、アプリの中で重ならない名前に変えます。キーを変えると保存した値の名前も変わるので、古いキーの値は読まれなくなります。

原因

Cookie Store APIはCookieに必ずSecureを付けます。Safariはhttp://localhostでもSecureのCookieを捨てます。

直し方

開発中もHTTPSで配信します。

テストをまたいで残る値

原因

ストアはモジュールの中の登録表に残り、保存した値もブラウザに残ります。

直し方

コンポーネントをアンマウントしてからresetStateRegistry()を呼びます。そのうえで、storageKeyやcookieNameで保存した値を消します。

テスト中のページ移動

原因

navigateイベントをintercept()するものが無いので、navigation.navigate()がページ全体の読み込みになります。

直し方

ルーターの代わりに、テストの中でnavigateイベントを受け取ってevent.intercept()を呼びます。

k8ordo

Baselineに入った機能を、制限なく使うReactのライブラリ群。