Document exceptions thrown

Hi Dartlang 'http' Module Maintainers,
Thanks for making this module. I'm using it in a new app. The app needs to know why a request failed so it can display an appropriate message to the user:
- Network problems: dns lookup failure, socket timeout, etc.
- Server error: malformed HTTP response, TLS negotiation failures, gzip error, etc.

How about documenting the various types of exceptions that the http methods can throw? I'm about to start reading the source to find out this information and then write brittle code that depends on undocumented implementation details. I would prefer not to do that. Help me out?

Cheers,
Michael