Confusing code example in futures-error-handling guide

[BorisNaguet]

Hello,

on this page:
https://www.dartlang.org/guides/libraries/futures-error-handling#completing-the-future-returned-by-whencomplete

this example:

void main() {
  funcThatThrows()
    .then((_) => print("Won't reach here..."))   // Future completes with an error.
    .whenComplete(() => print("... or here...")) // Future completes with the same error.
    .then((_) => print("... nor here."))         // Future completes with the same error.
    .catchError(handleError)                     // Error is handled here.
}

It's confusing, because "Won't reach here, or here, nor here" seems to mean that it won't be printed.
But "... or here..." is actually printed (but the error is transmitted on the next Future as the comments explain correctly).

I think it would be clearer with an executable code in dartpad like on other parts of the site.

[lrhn]

I agree that it is so misleading that it's probably just wrong. The whenComplete part should, and will, be printed.

[kwalrath]

@BorisNaguet you've convinced me that the page should feature DartPad. (I think its original version was from before DartPad's existence.)

[Sfshaza]

Yes, this piece was written years ago by our DPE, and long before DartPad existed. I think it's a great idea!

[kwalrath]

Related to #407.