`writeFile` support `AsyncIterable`, `Iterable` & `Stream` as `data` argument

[ronag]

https://nodejs.org/api/fs.html#fs_fs_writefile_file_data_options_callback

[ronag]

Writing an iterable, async iterable and stream can be done something like this:

const fsp = require('fs/promises')
const fileHandle = await fsp.open(filePath, flags)
try {
  for await (const buf of data) {
    if (signal?.aborted) {
      throw new AbortedError()
    }
    await fileHandle.write(buf)
  }
} finally {
  await fileHandle.close()
}

You could make a special version for stream which has better performance.

[yagipy]

I would like to work on this problem.

[yagipy]

@ronag
Does this issue include internal implementation?

Or is it just a doc fix like the PR below?
yagipy#1

[ronag]

It requires internal implementation.

[hyagihashi-cq]

@ronag
OK.

Is it like this image?

[ronag]

yes, maybe it is already implemented? I didn't know.

[hyagihashi-cq]

This is the code that I am implementing locally.

I will continue with the implementation.