@k8ordo/router

トラブルシューティング

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

このページの内容

リンクで起きる再読み込み

原因

リンク先のパスが、ルート表のどのパターンにも合っていません。ルーターが処理するのは、表に合うパスへのナビゲーションだけです。それ以外は、ブラウザの通常のページの読み込みになります。アプリをbaseの下で配信しているときは、baseの外のパスも同じです。

直し方

リンク先のパターンをルート表に足します。リンクをhrefで作り、Registerに表を登録しておくと、表に無いパターンは型エラーになります。

ファイルへのリンクで出る/*のページ

原因

ルート表の最後の/*は、どのパスにも合います。ホストが配信するファイルへのリンクも、ルーターが処理してしまいます。

直し方

ファイルへのリンクにdownload属性を付けます。ブラウザがダウンロードとして扱うので、ルーターは処理しません。

/products/newで出る/products/:idのページ

原因

照合はルート表を上から順にたどり、最初に合ったパターンを選びます。/products/:idが先に書かれていると、newも:idに合います。

直し方

/products/newのような固定のパターンを、:idのパターンより前に書きます。

useParams(…) rendered under …

原因

useParamsに渡したパターンと、そのコンポーネントを描画しているページのパターンが違います。複数のページで使うコンポーネントや、レイアウトの中で呼ぶと起きます。

直し方

ページのコンポーネントの中で、そのページのパターンを渡して呼びます。複数のページで使うコンポーネントでは、useRouteで型の無いparamsを読むか、useMatchで開いているページを調べます。

useRoute must render inside a matched <Router>

原因

useRouteとuseParamsは、<Router>の照合の結果を読みます。<Router>の外や、<Router>の無い@k8ordo/frameworkの下で呼ぶと、このエラーになります。

直し方

自分で<Router>を置くアプリでは、その下で呼びます。フレームワークの下では、Client Componentで今の場所を知るのにusePathnameかuseMatchを使います。ページがparamsを受け取る方法は、パラメータを見てください。

usePathname needs <Router> above it

原因

サーバーでの描画中とハイドレーション中は、ブラウザのURLを読めません。そのときusePathnameは、<Router>かフレームワークのランタイムが渡すパスを読みます。どちらも上に無いと、このエラーになります。

直し方

<Router>の下か、フレームワークが描画するページの中で使います。useInterceptedNavigationで自前のホストを作っているときは、<PathnameProvider>で描画中のパスを渡します。

bindParamsのnavigateToで効かないhistory

原因

パターンにparamがあると、2つ目の引数はいつもparamsとして読まれます。bindParamsがすべてのparamを渡していても同じなので、2つ目に渡したhistoryは無視されます。

直し方

2つ目にundefinedを渡し、オプションは3つ目に渡します。TypeScriptでは、2つ目に書いたオプションは型エラーになります。

ページより先に変わるアクティブなリンク

原因

ナビゲーションではURLが先に変わり、新しいページは準備ができてから画面に出ます。usePathnameとuseMatchはURLを読むので、前のページが出ている間に新しいパスを返します。ブラウザのアドレスバーと同じ順序です。

直し方

読み込み中を見せたいときは、usePendingPathnameで読み込み中のパスを読みます。自分で始めたナビゲーションなら、navigateToのfinishedを待ちます。

読み込み中に何も出ないReact.lazyのページ

原因

errorを書いたオブジェクトは、その下のページをfallbackがnullの<Suspense>で包みます。その下でReact.lazyのページがサスペンドすると、この<Suspense>がnullを出します。上のレイアウトの<Suspense>のfallbackは使われません。

直し方

同じオブジェクトにloadingを書くか、errorより下に<Suspense>を置きます。

AbortErrorでrejectするfinished

原因

そのナビゲーションが終わる前に、別のナビゲーションが始まりました。追い越されたナビゲーションは中断され、finishedは中断の理由でrejectします。

直し方

追い越されうる場所でfinishedを待つときは、名前がAbortErrorのDOMExceptionだけを無視します。ほかのエラーはそのままthrowし直します。

ボタンで起きるクロスフェード

原因

<ViewTransition>が、ページの切り替え以外のトランジションでも動いています。@k8ordo/uiのButtonのアクションの実行中もトランジションです。

直し方

<ViewTransition>のdefaultをnoneにし、updateに{ navigation: 'auto', default: 'none' }を渡します。ルーターが付けるnavigationの種類のときだけ動くようになります。

クエリの変更で消えないエラー

原因

ルート表のerrorの表示は、別のページに移ったときに消えます。クエリだけを変える状態の更新は、ページの切り替えに当たりません。表示はそのまま残ります。

直し方

errorのコンポーネントが受け取るresetを呼びます。その場でページが描画し直されます。

表に無いパターンでも出ない型エラー

原因

Registerのファイルが、TypeScriptの検査の対象に入っていません。フレームワークの下では、Registerを.k8ordoに生成します。ドットで始まるディレクトリは、includeに親のディレクトリを書いても読み飛ばされます。

直し方

Registerのファイルをincludeの範囲に入れます。フレームワークの下では、includeに.k8ordo/**/*.tsのグロブを書きます。

k8ordo

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