---
title: "openFile"
source: "https://browserpod.io/docs/reference/BrowserPod/openFile"
---

# openFile

Open an existing file in a BrowserPod Pod's virtual filesystem, returning a BinaryFile or TextFile handle depending on the mode you pass.

```ts
class BrowserPod {
  async openFile(path: string, mode: "binary"): Promise<BinaryFile>;
  async openFile(path: string, mode: "utf-8"): Promise<TextFile>;
}
```

## Parameters

- **path (`string`)** - Path to an existing file.
- **mode (`"binary" | "utf-8"`)** - Opening mode.

## Returns

`openFile` returns a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) which resolves to a [BinaryFile](https://browserpod.io/docs/reference/BinaryFile.md) object if `mode="binary"`, and to a [TextFile](https://browserpod.io/docs/reference/TextFile.md) object if `mode="utf-8"`. If the file does not exist, the [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) will be rejected.
