# session.Session.showHooks

- **Module:** session
- **Package:** libtmux
- **Language:** TypeScript
- **Kind:** method
- **Source:** https://github.com/libtmux/libtmux-ts/blob/073b9d7dedad900bff6f5ec0ea47794e40225870/packages/libtmux/src/session.ts#L230
- **Page:** https://libtmux.org/en/ts/latest/reference/session-session-showhooks/

```
showHooks(): Promise<
  ReadonlyMap<string, readonly string[]>
>
```

Every hook this session reports.

A hook is an array of commands, keyed by the name [`setHook`](/en/ts/latest/reference/session-session-sethook/) takes, so
what was set reads back under the name it was set with. tmux prints each
element as `name[0]`, which composes with neither of the writers.

## Examples

```ts
const hooks = await session.showHooks();
hooks.get("window-linked")?.[0];
```

## tmux command

The tmux commands behind `showHooks`.

- [`show-hooks`](/en/tmux/latest/manual/show-hooks/)

## tmux C API

The C declarations in tmux that implement these commands.

- [`cmd_show_hooks_entry`](/en/tmux/latest/reference/c-variable-cmd_show_hooks_entry/) (attribute)
- [`cmd_show_options_exec`](/en/tmux/latest/reference/c-function-cmd-show-options-c-cmd_show_options_exec/) (function)

## tmux hooks

Events that run tmux commands, with the scope each hook belongs to and where tmux fires it.

- [Hooks](/en/tmux/latest/catalog/hooks/) (hook)

## In other ports

Read a session's hooks

| Language | Equivalent |
| --- | --- |
| Python | [`libtmux.Session.show_hooks`](/en/py/latest/reference/libtmux-session-show_hooks/) (method) |
| Ruby | [`LibTmux::Session#hooks`](/en/ruby/latest/reference/libtmux-session-hooks/) (method) |
| Lua | [`libtmux.Session:list_hooks`](/en/lua/latest/reference/libtmux-session-list_hooks/) (method) |
| Rust | [`session.Session.hooks`](/en/rs/latest/reference/session-session-hooks/) (method) |
| Go | [`tmux.Session.Hooks`](/en/go/latest/reference/tmux-session-hooks/) (method) |
| Java | [`io.github.libtmux.Session.hooks`](/en/java/latest/reference/io-github-libtmux-session-session-hooks/) (method) |
| C# | [`LibTmux.Session.Hooks`](/en/csharp/latest/reference/libtmux-session-hooks/) (property) |
| C++ | [`libtmux::Session::hooks`](/en/cxx/latest/reference/libtmux-session-hooks/) (method) |
| Swift | [`Server.hooks(_:)`](/en/swift/latest/reference/server-hooks(_-)/) (method) |

No equivalent is recorded in PowerShell, Julia, Elixir, Kotlin, Scala or F#.