# client.Client

- **Module:** client
- **Package:** libtmux
- **Language:** TypeScript
- **Kind:** class
- **Source:** https://github.com/libtmux/libtmux-ts/blob/46cccfef2a546de55ce8b308249b8c76339089a0/packages/libtmux/src/client.ts#L27
- **Page:** https://libtmux.org/en/ts/latest/reference/client-client/

One client attached to a tmux server, as a handle rather than a copy of it.

Reached from [`Server.clients`](/en/ts/latest/reference/server-server-clients/); the constructor throws. A client is the
shortest-lived thing here — it goes away when its terminal does — so
[`Client.session`](/en/ts/latest/reference/client-client-session/) reports [`undefined`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/undefined) once it has detached, and every
other read reflects the moment the handle was made.

## Members

### Parent objects

- [`session`](/en/ts/latest/reference/client-client-session/) (method): The session this client is attached to, if it is still attached.
- [`server`](/en/ts/latest/reference/client-client-server/) (attribute): The server this handle addresses.

### Common operations

- [`detach`](/en/ts/latest/reference/client-client-detach/) (method): Detach this client from its server.
- [`pane`](/en/ts/latest/reference/client-client-pane/) (method): The pane this client currently has active.
- [`refreshed`](/en/ts/latest/reference/client-client-refreshed/) (method): This client, read again at a new instant.
- [`switchTo`](/en/ts/latest/reference/client-client-switchto/) (method): Point this client at a different session.
- [`window`](/en/ts/latest/reference/client-client-window/) (method): The window placement this client currently shows.

### Other members

- [`clientBrand`](/en/ts/latest/reference/client-client-clientbrand/) (attribute)
- [`constructor`](/en/ts/latest/reference/client-client-constructor/) (method)
- [`equals`](/en/ts/latest/reference/client-client-equals/) (method)
- [`format`](/en/ts/latest/reference/client-client-format/) (property): The raw tmux format row, addressed by tmux's own token names.
- [`toString`](/en/ts/latest/reference/client-client-tostring/) (method): How this handle renders in a log line, a template literal, or an error.

## Guides

Pages that discuss `Client`.

- [Server, session, window, pane](/en/ts/latest/concepts/server-session-window-pane/)