# LibTmux.Pane.capture!/3

- **Module:** LibTmux
- **Package:** libtmux
- **Language:** Elixir
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-elixir/blob/66b9b1c3f3f3186428abdfda2c76f5cf87446710/lib/libtmux/entities.ex#L392
- **Page:** https://libtmux.org/en/elixir/latest/reference/libtmux-pane-capture-bang-3/

```
capture!(connection, ref, options \\ [])
@spec capture!(
        LibTmux.Action.connection(),
        LibTmux.Ref.t(),
        [capture_option()]
      ) :: binary()
```

Returns screen bytes when `capture/3` completes; raises API errors or `LibTmux.Action.CompletionError` otherwise.

## Parameters

- `connection` (`LibTmux.Action.connection()`)
- `ref` (`LibTmux.Ref.t()`)
- `options` (`[capture_option()]`)