Dart FutureクラスのcatchError()メソッドでのエラー捕捉について

Question

https://dart.dev/guides/libraries/library-tour#dartasync---asynchronous-programming

上記ページのエラー処理の説明を読んでいるんですが、

Important: Be sure to invoke catchError() on the result of then()—not on the result of the original Future. Otherwise, the catchError() can handle errors only from the original Future’s computation, but not from the handler registered by then().

上記の説明なんですが、これは例えば

//sample1
Future<String> one()   => new Future.value("from one1");
Future<String> twoOne()   => new Future.error("error from 21");


Future<void> main() async {
  one()
    .catchError(
      (e){
        print("エラー内容  : $e");
      }
    );
}
/*
(何も表示されない)
*/

sample1の呼び出し方だと、one()が返すfutureのエラーしかキャッチできませんよ。(上記コードではone()でエラーは出ないので、エラー内容は何も表示されませんが)
しかし

//sample2
Future<String> one()   => new Future.value("from one1");
Future<String> twoOne()   => new Future.error("error from 21");

Future<void> main() async {
  one()
    .then(
      (_){
        print("one completed");
        twoOne();
      }
    )
    .catchError(
      (e){
        print("エラー内容  : $e");
      }
    );
}
/*
one completed
*/

sample2のように呼び出せば、thenのコールバックの中で発生したエラー(つまりtwoOne()のエラー)もcatchError()メソッドで捕捉できますよ。

という説明ではないんでしょうか?そうとしか読めないんですが。

でも実際動かしてみると

one completed

しか表示されません。これって
twoOne()
で発生したエラーがcatchError()メソッドで捕捉されていないと思うのですが。

これって何なんでしょうか。仕様が変わったけどドキュメントに反映されていない、みたいなことなんでしょうか。

Comments

[satokei]

> but not from the handler registered by then().
私は、then()で発生したエラーは補足できないと理解しました。

[moriman]

回答を頂きましてありがとうございます。

私としては、英文の訳は、

重要:catchErrorはオリジナルのfutureに対してではなく、thenの返り値に対して呼び出しましょう。そうしないと、catchErrorはオリジナルのfutureの計算のエラー処理しかできません。thenで登録されたhandler(コールバック)のエラーを処理できません。

という認識です。この訳だと、「thenの返り値に対してcatchErrorを呼び出せば、thenのコールバックでのエラーも捕捉できる」ということなのではないか?という認識なのですが。

[satokei]

返答が遅くなりました。
私の理解が間違っていましたが、私なりに理解した内容を回答いたしました。

Answer 1

おそらく該当の文章は、以下を意図しているのだと思います。

• 間違った記述

  one()
    .catchError((e) {
      print("エラー内容  : $e");
    })
    .then((_) {
      print("one completed");
      throw "error!!";
    });
/*=== 実行結果 ===
one completed
*/

• 正しい記述

  await one()
    .then((_) {
      print("one completed");
      throw "error!!";
    })
    .catchError((e) {
      print("エラー内容  : $e");
    });
/*=== 実行結果 ===
one completed
エラー内容  : error!!
*/

　

質問のコード「sample2」は、
以下のように記述すると意図した動作になりますので、
エラーの投げ方の問題のような気がします。

  one()
    .then(
      (_) async {
        print("one completed");
        await twoOne();
      }
    )
    .catchError(
      (e){
        print("エラー内容  : $e");
      }
    );

　
ちなみに、通常は以下のように記述すると思います。

  one()
    .then((_) => print("one completed"))
    .then((_) => twoOne())
    .catchError((e) {
      print("エラー内容  : $e");
    });