Graceful shutdown of the websocket connection.

[markusthoemmes]

It seems like to achieve a "normal" shutdown of a websocket connection, one needs to do a dance like:

1. Send Close message
2. Wait for receiving a Close message
3. Actually close the connection

The Close method of today closes the connection immediately, without warning or graceful shutdown. Would it be desirable to have a Shutdown method like golang's http servers, which does the dance explained above for the user?

I think this is desirable to have, as well as in-built support for checking liveness using ping/pong and deadlines. Most applications need these features.

The current API mostly handles the wire format. The only thing the package does above the wire format is respond to ping and respond to close. This low-level API provides flexibility for the applications that need it (like the one I work on), but most don't need this flexibility.

This package can benefit from a high-level API that wraps up all these things that applications need: shutdown, checking liveness, concurrent sends, ...

[ankur0493]

@garyburd Can you please assign this issue to me. I would like to work on it.

[elithrar]

(Can’t assign to non-maintainers of a repo. I think it’s fair just note that @ankur0493 has it & follow up!)

…

On Sun, Dec 9, 2018 at 7:44 PM Gary Burd ***@***.***> wrote: @ankur0493 <https://github.com/ankur0493> Please post a proposed API and overview of the implementation for discussion. I tried to assign you to this issue, but Github will not let me do it. Please let me know what I need to do. — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub <#448 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AABIcJ-3eUsrZCkdzplRzK_dqmoxrQhwks5u3dh-gaJpZM4YOjKk> .

[ankur0493]

Thanks @garyburd. Will soon share the API details.

[nhooyr]

For someone who wants this now, I've implemented it in nhooyr.io/websocket@v1.7.0

See discussion in coder/websocket#160