errorCaptured 子孫のエラーを捕捉

最終更新:2026-10-22

errorCaptured 子孫のエラーを捕捉

errorCaptured は子孫コンポーネントのエラーを捕捉します。false を返すとグローバルハンドラーへの伝播を止められます。

グループオプション: 描画とライフサイクル
種類オプション
スコープコンポーネント内
Vue バージョン3.0+
SSR 対応対応

📝 構文

export default {
  errorCaptured(err, vm, info) {
    return false   // stop propagation
  }
}

⚙️ 引数

valueerr、vm、発生元を説明する info 文字列

戻り値:false を返すと伝播を止められます

▶ 例

以下のコードを編集して結果を確認しましょう:

出力:

Shows 'caught: child failed to initialise' without a blank screen.

💡 ポイント

💡 ヒント 最上位で捕捉して監視へ報告します。
⚠️ 注意 同期エラーのみ対象です。Promise の拒否は自分で処理してください。
ℹ️ 補足 エラーはまず最も近い境界へバブルアップします。
関連ケースは近日公開予定。

📚 関連チュートリアル

❓ よくある質問

Q 非同期エラーも捕捉できますか?
A できません。同期エラーのみです。
Q グローバル errorHandler との関係は?
A false を返せばここで止まり、そうでなければグローバルハンドラーへ届きます。
Q フォールバック UI はどう作りますか?
A 捕捉時に状態を設定し、v-if でフォールバックビューへ切り替えます。
Web-Tutorial.com

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

100%