# types.TmuxSubscriptionEvent

- **Module:** types
- **Package:** libtmux
- **Language:** TypeScript
- **Kind:** interface
- **Source:** https://github.com/libtmux/libtmux-ts/blob/3fe1ca654b81b8cbf4a13b777a001a3298c87a6f/packages/libtmux/src/types.ts#L619
- **Page:** https://libtmux.org/en/ts/latest/reference/types-tmuxsubscriptionevent/

A subscribed format expanded to a new value.

tmux evaluates a subscription at most once per second and reports only when
the value differs from the last report for that object; the first evaluation
always reports. `windowId`, `windowIndex` and `paneId` are the object the
value was expanded against, and are absent for a session-scope subscription.

The value is written raw, so a format expanding to a newline arrives as
further lines this parser cannot attribute. Keep a subscribed format on one
line.

## Members

- `kind` (property)
- `name` (property): The name given when subscribing.
- `paneId` (property)
- `sessionId` (property)
- `value` (property): The expanded format. Empty when the format expanded to nothing.
- `windowId` (property)
- `windowIndex` (property): The window's index within the session.