# Clarification on connection-change behavior with fail state and failover reason

**URL:** <https://devforum.zoom.us/t/clarification-on-connection-change-behavior-with-fail-state-and-failover-reason/134047>\
**Category:** Video SDK\
**Created:** [June 16, 2025, 5:46am UTC](https://devforum.zoom.us/t/clarification-on-connection-change-behavior-with-fail-state-and-failover-reason/134047 "2025-06-16T05:46:41Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![anhtv](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/anhtv/32/67823_2.png) [@anhtv](https://devforum.zoom.us/u/anhtv)\
**Post date:** [June 16, 2025, 5:46am UTC](https://devforum.zoom.us/t/clarification-on-connection-change-behavior-with-fail-state-and-failover-reason/134047/1 "2025-06-16T05:46:41Z")

</div>

I would like to request clarification regarding the behavior of the `connection-change` event emitted by the Zoom Web Video SDK.

1. Under what circumstances does the SDK emit a `connection-change` event with `ConnectionState.Fail` or `ReconnectReason.Failover`?

- Does this indicate a network disruption, session termination, or internal reconnection attempt?

1. After receiving this event, will the SDK emit any **subsequent `connection-change` events** , such as one with `ConnectionState.Closed`?

- If so, what is the expected delay or timeout before that final `closed` event is emitted?

1. In the case of `ConnectionState.Fail`, is it recommended for the application to explicitly call `leave()` or wait for a potential recovery or final `closed` state?
2. Does the SDK internally attempt to reconnect after emitting a `fail` or `failover` state?

Thank you very much in advance for your support.

---

<div class="post-metadata">

**Author:** ![ticorrian.heard](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/ticorrian.heard/32/70213_2.png) [@ticorrian.heard](https://devforum.zoom.us/u/ticorrian.heard)\
**Post date:** [June 17, 2025, 11:59pm UTC](https://devforum.zoom.us/t/clarification-on-connection-change-behavior-with-fail-state-and-failover-reason/134047/2 "2025-06-17T23:59:18Z")

</div>

Hi @anhtv I can help assist with these questions. I will respond shortly with the answers to your questions

---

<div class="post-metadata">

**Author:** ![vic.yang](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/vic.yang/32/24656_2.png) [@vic.yang](https://devforum.zoom.us/u/vic.yang)\
**Post date:** [June 18, 2025, 1:54am UTC](https://devforum.zoom.us/t/clarification-on-connection-change-behavior-with-fail-state-and-failover-reason/134047/3 "2025-06-18T01:54:39Z")

</div>

Hi @anhtv

Thanks for your feedback.

> Under what circumstances does the SDK emit a `connection-change` event with `ConnectionState.Fail` or `ReconnectReason.Failover`

- `ConnectionState.Fail` : Join session failed, which could occur during the initial join or while reconnecting. Possible reasons include network disconnection, an invalid JWT token, or the session having already ended.

- `ConnectionState.Reconnecting` with `reason: ReconnectReason.Failover`: A brief network interruption or an unexpected disconnection from the server triggered the reconnection. Video SDK will automatically reconnect and restore the state before the disconnection, so there’s no need to manually call the `join` method.

> After receiving this event, will the SDK emit any **subsequent `connection-change` events** , such as one with `ConnectionState.Closed`

Depends on the case.

- `ConnectionState.Fail`: This is a terminal state—reconnection failed.
- `ConnectionState.Reconnecting`: If reconnection succeeds, a subsequent `ConnectionState.Connected` event will be emitted.

> In the case of `ConnectionState.Fail`, is it recommended for the application to explicitly call `leave()` or wait for a potential recovery or final `closed` state?

No.

> Does the SDK internally attempt to reconnect after emitting a `fail` or `failover` state?

- `ConnectionState.Fail`: This is a terminal state, there will be no retry for joining the session.
- `ConnectionState.Reconnecting`: Video SDK will attempt to reconnect to the session automatically.

Thanks  
Vic

---

<div class="post-metadata">

**Author:** ![anhtv](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/anhtv/32/67823_2.png) [@anhtv](https://devforum.zoom.us/u/anhtv)\
**Post date:** [June 18, 2025, 3:40am UTC](https://devforum.zoom.us/t/clarification-on-connection-change-behavior-with-fail-state-and-failover-reason/134047/4 "2025-06-18T03:40:27Z")

</div>

Thank you so much for your help!

---

<div class="post-metadata">

**Author:** ![ekaansh.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/ekaansh.zoom/32/55004_2.png) [@ekaansh.zoom](https://devforum.zoom.us/u/ekaansh.zoom)\
**Post date:** [June 18, 2025, 8:30am UTC](https://devforum.zoom.us/t/clarification-on-connection-change-behavior-with-fail-state-and-failover-reason/134047/5 "2025-06-18T08:30:09Z")

</div>

Closed on June 18, 2025, 8:30am UTC


