パニックの処理
Wails アプリケーションでパニックを処理する方法
Go アプリケーションでは、予期しない事態が発生すると、実行時にパニックが起こることがあります。このガイドでは、一般的な Go コードと Wails アプリケーション固有のコードの両方でパニックを処理する方法について説明します。
Go のパニックを理解する
Wails 固有のパニック処理について詳しく見る前に、Go でパニックがどのように機能するかを理解しておくことが重要です。
- パニックは、通常の動作中には発生しないはずの回復不能なエラーに使用します
- goroutine でパニックが発生した場合、影響を受けるのはその goroutine だけです
- パニックからは、
deferとrecover()を使用して回復できます
Go でパニックを処理する基本的な例を次に示します。
func doSomething() {
// Deferred functions run even when a panic occurs
defer func() {
if r := recover(); r != nil {
fmt.Printf("Recovered from panic: %v\n", r)
}
}()
// Your code that might panic
panic("something went wrong")
}Go の panic と recover の詳細については、Go Blog：Defer、Panic、Recoverを参照してください。
Wails でのパニック処理
Wails は、フロントエンドから呼び出された Service メソッドで発生するパニックを自動的に処理します。そのため、これらのメソッドにパニックからの回復処理を追加する必要はありません。Wails がパニックを捕捉し、設定済みのパニックハンドラーで処理します。
パニックハンドラーは、特に次のパニックを捕捉するよう設計されています。
- フロントエンドから呼び出された、バインド済みサービスメソッド内のパニック
- Wails ランタイム内部のパニック
バックグラウンドの goroutine や独立した Go コードなど、その他の状況では、Go の標準的なパニック回復機構を使用して自分でパニックを処理してください。
PanicDetails 構造体
パニックが発生すると、Wails はパニックに関する重要な情報をPanicDetails構造体に記録します。
type PanicDetails struct {
StackTrace string // The stack trace of where the panic occurred. Potentially trimmed to provide more context
Error error // The error that caused the panic
Time time.Time // The time when the panic occurred
FullStackTrace string // The complete stack trace including runtime frames
}この構造体は、パニックに関する包括的な情報を提供します。
StackTrace：パニックに至った呼び出しスタックを示す、整形済みの文字列Error：実際のエラーまたはパニックメッセージTime：パニックが発生した正確な時刻FullStackTrace：ランタイムフレームを含む完全なスタックトレース
デフォルトのパニックハンドラー
カスタムパニックハンドラーを指定しない場合、Wails はデフォルトのハンドラーを使用します。このハンドラーは、整形したログメッセージとしてエラー情報を出力した後、終了します。 例：
************************ FATAL ******************************
* There has been a catastrophic failure in your application *
********************* Error Details *************************
panic error: oh no! something went wrong deep in my service! :(
main.(*WindowService).call2
at E:/wails/v3/examples/panic-handling/main.go:23
main.(*WindowService).call1
at E:/wails/v3/examples/panic-handling/main.go:19
main.(*WindowService).GeneratePanic
at E:/wails/v3/examples/panic-handling/main.go:15
*************************************************************カスタムパニックハンドラー
アプリケーションの作成時にPanicHandlerオプションを設定することで、独自のパニックハンドラーを実装できます。例を次に示します。
app := application.New(application.Options{
Name: "My App",
PanicHandler: func(panicDetails *application.PanicDetails) {
fmt.Printf("*** Custom Panic Handler ***\n")
fmt.Printf("Time: %s\n", panicDetails.Time)
fmt.Printf("Error: %s\n", panicDetails.Error)
fmt.Printf("Stacktrace: %s\n", panicDetails.StackTrace)
fmt.Printf("Full Stacktrace: %s\n", panicDetails.FullStackTrace)
// You could also:
// - Log to a file
// - Send to a crash reporting service
// - Show a user-friendly error dialog
// - Attempt to recover or restart the application
},
})Wails アプリケーションでのパニック処理について、完全に動作する例は、v3/examples/panic-handlingにある panic-handling の例を参照してください。
最後に
Wails のパニックハンドラーは、バインド済みメソッド内のパニックとランタイム内部のエラーを処理するためのものであることに注意してください。アプリケーションのその他の部分では、必要に応じて Go の標準的なエラー処理パターンとパニック回復機構を使用してください。すべての Go アプリケーションと同様に、可能な限り適切なエラー処理によってパニックを防ぐことが望まれます。