# session.Session.showOptions

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

```
showOptions(
  options?: CommandOptions,
): Promise<ReadonlyMap<string, string>>
```

Every option set on this session itself, not the ones it inherits.

A fresh session usually has none, so an empty map here means nothing was
set on this session — not that the option has no value. [`showResolvedOptions`](/en/ts/latest/reference/session-session-showresolvedoptions/)
answers what actually governs it.

## Examples

```ts
const options = await session.showOptions();
options.get("status");
```

## Parameters

- `options?` (`CommandOptions`)

## tmux command

The tmux commands behind `showOptions`.

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

## tmux C API

The C declarations in tmux that implement these commands.

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

## tmux options

Settings for the server, sessions, windows and panes, with their types, defaults and allowed values.

- [Options](/en/tmux/latest/catalog/options/) (option)

## In other ports

Read the options set on a session

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

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