Server.query_panes

Description#

Acquire and return a new LibTmux::PaneSelection in captured physical-pane order. where accepts a hash reference or LibTmux::Filter. auto verifies safe scalar candidates after complete local evaluation; never disables the native comparison. The default auto costs one extra command and supervisor when lowering is available; it does not reduce acquisition. Select never when only the captured answer is needed. require throws "Unsupported" in LibTmux::X unless lowering is exact, or "QueryMismatch" in LibTmux::X on disagreement. native_filter is an exclusive expert escape hatch. Empty successful matches remain a typed selection; acquisition/evaluation failures propagate.

on_verification receives one detached report hashref in void context after a successful decision, including auto fallback. It runs inline once; its return is ignored and exceptions propagate unchanged unless the operation has already been cancelled. Cancellation suppresses subsequent result/error delivery. Failed queries do not invoke it. Report edits cannot change the returned selection. See "VERIFICATION REPORT" and "explain_panes".

    my $panes = $server->query_panes(where => {active => true}, pushdown => 'auto');