【Python3.x】BaseExceptionGroup::__context__定数の使い方

__context__定数は、Pythonにおける例外オブジェクトが持つ特別な属性の一つであり、BaseExceptionGroupクラスのインスタンスもこの属性を持ちます。これは、現在の例外が発生する前に、処理されていた別の例外への参照を保持するために使用されます。

具体的には、ある例外の処理中に別の例外が発生した場合、新しく発生した例外の__context__には、その直前までアクティブだった例外オブジェクトが自動的に格納されます。これにより、例外と例外がどのような順番で発生したかという「例外連鎖」を形成し、プログラムのどこで問題が発生したのかを追跡するための重要な情報を提供します。

BaseExceptionGroupは、複数の例外をまとめて扱うための基底クラスですが、そのインスタンスが持つ__context__も、他の通常の例外と同様に機能します。例えば、複数の非同期処理が同時に実行され、それぞれが異なるエラーで失敗し、それらのエラーがExceptionGroupとしてまとめられた際に、もしそのExceptionGroup自体がさらに別の処理の中で発生した場合、そのExceptionGroupの__context__には、直前の例外が設定される可能性があります。

この属性は、raise eのように例外を再送出する際に、以前の例外を自動的に捕捉して連鎖させる働きがあります。デバッグの際には、トレースバック（エラーの履歴）でこの連鎖情報が提供されるため、根本原因の特定に非常に役立ちます。__context__が設定されていない場合はNoneとなります。この仕組みは、プログラムの予期せぬ挙動を深く理解し、効率的に修正するために不可欠です。

Copy
1try:
2    raise ValueError("Original context error")
3except ValueError as original_error:
4    try:
5        raise BaseExceptionGroup("Grouped errors", [TypeError("Invalid type")])
6    except BaseExceptionGroup as eg:
7        # eg.__context__ は original_error (ValueError) を参照します
8        context_exception = eg.__context__

引数なし

引数はありません

BaseException | None

この属性は、例外が発生した際に、その例外をラップまたは連鎖させた別の例外オブジェクト（BaseException型）を返します。もし連鎖する例外がない場合は、Noneを返します。