the send method does not automatically respond with a 101 status

mojolicious · Apr 8, 2015 · eb71ecd · eb71ecd
1 parent 2b6dabd
commit eb71ecd
Show file tree

Hide file tree

Showing 2 changed files with 22 additions and 3 deletions.
diff --git a/lib/Mojolicious/Guides/Cookbook.pod b/lib/Mojolicious/Guides/Cookbook.pod
@@ -569,7 +569,7 @@ all of its subscribers.
 
 The WebSocket protocol offers full bi-directional low-latency communication
 channels between clients and servers. Receive messages just by subscribing to
-events such as L<Mojo::Transaction::WebSocket/"message"> with the method
+events such as L<Mojo::Transaction::WebSocket/"message"> with
 L<Mojolicious::Controller/"on"> and return them with
 L<Mojolicious::Controller/"send">.
 
@@ -623,6 +623,26 @@ L<Mojolicious::Controller/"send">.
     </body>
   </html>
 
+The connection gets established when you respond to the WebSocket handshake
+request, which is a normal HTTP C<GET> request, with a C<101> response status,
+which happens automatically if you subscribe to an event with
+L<Mojolicious::Controller/"on">.
+
+  GET /echo HTTP/1.1
+  Host: 127.0.0.1:3000
+  User-Agent: Mojolicious (Perl)
+  Connection: Upgrade
+  Upgrade: websocket
+  Sec-WebSocket-Key: IDM3ODE4NDk2MjA1OTcxOQ==
+  Sec-WebSocket-Version: 13
+
+  HTTP/1.1 101 Switching Protocols
+  Server: Mojolicious (Perl)
+  Date: Tue, 03 Feb 2015 17:08:24 GMT
+  Connection: Upgrade
+  Upgrade: websocket
+  Sec-WebSocket-Accept: SWsp5N2iNxPbHlcOTIw8ERvyVPY=
+
 The event L<Mojo::Transaction::WebSocket/"finish"> will be emitted right after
 the WebSocket connection has been closed.
 

diff --git a/lib/Mojolicious/Guides/Routing.pod b/lib/Mojolicious/Guides/Routing.pod
@@ -638,8 +638,7 @@ additional information.
 
 The connection gets established when you respond to the WebSocket handshake
 request with a C<101> response status, which happens automatically if you
-subscribe to an event with L<Mojolicious::Controller/"on"> or send a message
-with L<Mojolicious::Controller/"send"> right away.
+subscribe to an event with L<Mojolicious::Controller/"on">.
 
   GET /echo HTTP/1.1
   Host: mojolicio.us