# `PhoenixReplay.Capture.LiveComponents`
[🔗](https://github.com/elixir-vibe/phoenix_replay/blob/v0.6.2/lib/phoenix_replay/capture/live_components.ex#L1)

Records LiveComponent state from LiveView's telemetry events.

LiveComponents have no `on_mount` hook, but LiveView emits
`[:phoenix, :live_component, :update | :handle_event, :stop]` and
`[:phoenix, :live_component, :destroyed]` from the LiveView process with
the component's socket. The handlers attached here run in that process,
find its session in `PhoenixReplay.Session.Buffer`, and record:

  * `:event` — `%{name: String.t(), params: map, target: {module, id}}`,
    an event handled by a component, which the view's own hooks never see
  * `:component` — `%{module: module, id: term, assigns: map}`, the
    component assigns changed by an update or event
  * `:component_destroyed` — `%{module: module, id: term}`

LiveView does not yet emit telemetry for async results applied to a
component; `PhoenixReplay.Capture.AsyncResults` covers them until it
does.

Components of LiveViews that are not recorded cost one ETS lookup per
event. Assigns go through the session's `PhoenixReplay.Sanitizer`.

`:telemetry` detaches a handler that raises, which would stop component
recording for the whole application, so the handlers match metadata
loosely and ignore shapes they do not expect, and a failure is reported
with `[:phoenix_replay, :collector, :exception]`, as collectors' are.

# `attach`

```elixir
@spec attach() :: :ok | {:error, :already_exists}
```

Attaches the telemetry handlers. Called by `PhoenixReplay.Capture.Handlers`.

# `detach`

```elixir
@spec detach() :: :ok
```

Detaches the telemetry handlers, if attached.

# `handle_event`

```elixir
@spec handle_event([atom()], map(), map(), term()) :: :ok
```

Handles a LiveComponent telemetry event in the LiveView process. A
failure, such as a custom sanitizer raising, is reported with
`PhoenixReplay.Telemetry.collector_failed/5` instead of raised:
`:telemetry` would detach the handler for the whole application.

---

*Consult [api-reference.md](api-reference.md) for complete listing*
