トラブルシューティング
よくある症状の原因と直し方です。エラー文で探すときは、ページの中を検索してください。
このページの内容
リンクで起きる再読み込み
原因
リンク先のパスが、ルート表のどのパターンにも合っていません。ルーターが処理するのは、表に合うパスへのナビゲーションだけです。それ以外は、ブラウザの通常のページの読み込みになります。アプリを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のグロブを書きます。