Pane.dead

Description#

Dying is something that happens between reads, so a cached answer would report a pane that died after this handle was captured as alive forever — the trap a snapshot-backed isDead() would set, which is why there is no such accessor on the capture itself. This asks tmux directly instead, every time.

A dead pane is not necessarily a gone one: remain-on-exit keeps it around, still listed, to be read. A pane with no remain-on-exit is simply removed once its process exits — #refresh() on this handle then throws TargetGoneException, and this method throws too. Unlike every other command Pane sends, display-message -t does not error on a target it cannot resolve — it exits 0 with nothing on stdout — so a gone pane looks like a live one that answered nothing rather than like a failure. That empty read, and not a "can't find pane" from tmux, is what this method throws on: a real pane always answers 0 or 1 for this format, never nothing.