---
title: "Handle"
source: "https://github.com/remix-run/remix/blob/remix@3.0.0/packages/component/src/runtime/component.ts#L14"
---

# Handle

## Summary

Runtime handle passed to component setup functions.

## Signature

```ts
interface Handle<Props, ContextValue> {
  context: Context<ContextValue>
  frame: FrameHandle
  frames: { top: FrameHandle; get: any }
  id: string
  props: Props
  signal: AbortSignal
  queueTask(task: Task): void
  update(): Promise<AbortSignal>
}

```

## Properties

### `context`

Set and get values in an element tree for indirect ancestor/descendant
communication.

### `frame`

The component's closest frame

### `frames`

Access named frames in the current runtime tree.

### `id`

Stable identifier per component instance. Useful for HTML APIs like
htmlFor, aria-owns, etc. so consumers don't have to supply an id.

### `props`

Stable props object for the component instance. The object identity does not
change across updates, but its values are updated before each render.

### `signal`

A signal indicating the connected status of the component. When the
component is disconnected from the tree the signal will be aborted.
Useful for setup scope cleanup.

## Methods

### `queueTask(task: Task): void`

Schedules a task to run after the next update.

#### Parameters

##### `task`

Work receiving a signal aborted on the next render or component removal.

### `update(): Promise<AbortSignal>`

Schedules an update for the component to render again. Returns a promise
that resolves with an AbortSignal after the update completes. Call this
from an event handler, queued task, or other work that runs after the
component commits. The signal is aborted when the component re-renders or
is removed. Calling this during setup warns and skips the extra render;
the promise resolves after the initial commit.