errorCaptured 子孫のエラーを捕捉
最終更新:2026-10-22
errorCaptured 子孫のエラーを捕捉
errorCaptured は子孫コンポーネントのエラーを捕捉します。false を返すとグローバルハンドラーへの伝播を止められます。
| グループ | オプション: 描画とライフサイクル |
|---|---|
| 種類 | オプション |
| スコープ | コンポーネント内 |
| Vue バージョン | 3.0+ |
| SSR 対応 | 対応 |
📝 構文
export default {
errorCaptured(err, vm, info) {
return false // stop propagation
}
}
⚙️ 引数
| value | err、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 でフォールバックビューへ切り替えます。