diff --git a/doc/api/fs.md b/doc/api/fs.md index 3be576e175eed5..fdb7d93214ee1f 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -302,52 +302,6 @@ Reads data from the file and stores that in the given buffer. If the file is not modified concurrently, the end-of-file is reached when the number of bytes read is zero. -#### `filehandle.readableWebStream()` - - -> Stability: 1 - Experimental - -* Returns: {ReadableStream} - -Returns a `ReadableStream` that may be used to read the files data. - -An error will be thrown if this method is called more than once or is called -after the `FileHandle` is closed or closing. - -```mjs -import { - open, -} from 'node:fs/promises'; - -const file = await open('./some/file/to/read'); - -for await (const chunk of file.readableWebStream()) - console.log(chunk); - -await file.close(); -``` - -```cjs -const { - open, -} = require('fs/promises'); - -(async () => { - const file = await open('./some/file/to/read'); - - for await (const chunk of file.readableWebStream()) - console.log(chunk); - - await file.close(); -})(); -``` - -While the `ReadableStream` will read the file to completion, it will not -close the `FileHandle` automatically. User code must still call the -`fileHandle.close()` method. - #### `filehandle.readFile(options)` + +> Stability: 1 - Experimental + +* Returns: {ReadableStream} + +Returns a `ReadableStream` that may be used to read the files data. + +An error will be thrown if this method is called more than once or is called +after the `FileHandle` is closed or closing. + +```mjs +import { + open, +} from 'node:fs/promises'; + +const file = await open('./some/file/to/read'); + +for await (const chunk of file.stream()) + console.log(chunk); + +await file.close(); +``` + +```cjs +const { + open, +} = require('fs/promises'); + +(async () => { + const file = await open('./some/file/to/read'); + + for await (const chunk of file.stream()) + console.log(chunk); + + await file.close(); +})(); +``` + +While the `ReadableStream` will read the file to completion, it will not +close the `FileHandle` automatically. User code must still call the +`fileHandle.close()` method. + #### `filehandle.sync()`