Re: [directory-upload] Easier way to get files without complicated asynchronous traversal code (#26)

Earlier on we ran some tests to verify the performance impact of processing very large directories with many files and sub-directories. It turns out that there is better perceived performance when providing files and sub-directories at 1 level deep rather than waiting for the entire directory structure to be processed all at once since developers would be able to provide more timely feedback to the user. The added benefit is that you can kick off the uploads for the files that you have already retrieved as you continue to receive more files. Originally, we wanted to take advantage of `AsyncIterators` as mentioned by @arunranga, but we opted for Promises with the compromise that we would need to allow for more incremental feedback to the developer. Having said that, I believe that we should continue to not have a way to retrieve a flattened file list until we have a more robust primitive such as `AsyncIterator` to allow for better user experiences.

---
Reply to this email directly or view it on GitHub:
https://github.com/WICG/directory-upload/issues/26#issuecomment-173399547