> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bijection.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Interface: FileHandle

> An ephemeral authenticated handle to fixed bytes.

[browser](/api/modules/browser).FileHandle

An ephemeral authenticated handle to fixed bytes. Serialize `ref`, never this handle.

## Properties

### ref

• `Readonly` **ref**: [`FileRef`](/api/modules/values#fileref)

## Methods

### read

▸ **read**(`options?`): `Promise`\<[`ProtectedFile`](/api/modules/browser#protectedfile)>

Uses the client's current authentication and rechecks the selected route.

#### Parameters

| Name | Type |
| :- | :- |
| `options?` | `Pick`\<[`ProtectedFileOptions`](/api/modules/browser#protectedfileoptions), `"range"` \| `"signal"` \| `"stallTimeoutMs"`> |

#### Returns

`Promise`\<[`ProtectedFile`](/api/modules/browser#protectedfile)>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.