Skip to main content

Read a file as a ReadableStream

The Bun.file() function accepts a path and returns a BunFile instance. BunFile extends Blob, so you can read the file lazily in a variety of formats. Use .stream() to consume the file incrementally as a ReadableStream.

const path = "/path/to/package.json";
const file = Bun.file(path);

const stream = file.stream();

The stream is an async iterable, so you can read its chunks with for await.

for await (const chunk of stream) {
  chunk; // => Uint8Array
}

See Streams for more on working with streams in Bun.

Translation © 2026 fanyi.dev · Original © 2026 the Bun project (LICENSE.md names no copyright holder) (MIT)