Skip to main content

Bun home page

[Runtime

](../../../index.md)[Package Manager

](../../../pm/cli/install/index.md)[Bundler

](../../../bundler/index.md)[Test Runner

](../../../test/index.md)[Guides

](../../index.md)[Reference

](https://bun.com/reference)[Blog

](https://bun.com/blog)[Feedback

](../../../feedback/index.md)

The Bun.file() function accepts a path and returns a BunFile instance. The BunFile class extends Blob and allows you to lazily read the file 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 chunks of the stream can be consumed as an async iterable using for await.

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

Refer to the Streams documentation for more information on working with streams in Bun.

Was this page helpful?

Suggest editsRaise issue

[

Watch a directory for changes

Previous

](../watch/index.md)[

Write a string to a file

Next

](../../write-file/basic/index.md)