Package dart:io should document exceptions

[weenzeel]

Hi!

The package dart:io should document exceptions thrown.

E.g. The exception thrown by the code bellow isn't mentioned in documentation comments, and aren't discoverable by looking at the dart implementation of the methods used.

import 'dart:io';

...
var dir = Directory('/Users/Path/To/Folder/That/Dosent/Exist/');
var entityList = dir.listSync(recursive: true, followLinks: false);
...

Thanks

Dart SDK version: 2.10.4 (stable)
MacOS

[mleonhard]

I need to know if dart:io:HttpClientRequest.abort throws exceptions. I wasted several minutes searching and finally found the actual code of the function in sdk/lib/_http/http_impl.dart . It appears to not throw.

The Dart & Flutter documentation is incomplete. Dart Team & Flutter Team, please please please finish the documentation. It won't get you promoted and earn you more money, but it's really important to us, your users. CC: @timsneath (Flutter PM)