{"id":38,"date":"2024-02-13T14:17:10","date_gmt":"2024-02-13T11:17:10","guid":{"rendered":"http:\/\/caitiem.com\/?p=38"},"modified":"2024-02-13T15:28:35","modified_gmt":"2024-02-13T12:28:35","slug":"a-websocket-primer","status":"publish","type":"post","link":"http:\/\/www.caitiem.com\/2013\/12\/02\/a-websocket-primer\/","title":{"rendered":"A WebSocket Primer"},"content":{"rendered":"\n<p>Over the past year, prior to leaving 343, I spent a large amount of time working with the WebSockets protocol and upgrading the Halo Services to support it.\u00a0 In order to solidify my knowledge and provide a handy refresher for when this information invariably gets context switched out of my brain in the future, I decided to write a primer on WebSockets.\u00a0 Hopefully other people will find the introduction to this new protocol useful as well.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Overview<\/strong><\/h2>\n\n\n\n<p>In December 2011 the IETF standardized the WebSocket protocol.\u00a0 Unlike the typical Request\/Response messaging patterns provided by HTTP, this network protocol provides a full-duplex communication channel between a host and a client over TCP.\u00a0 This enables server sent events, reactive user experiences, and real time components.<\/p>\n\n\n\n<p>The WebSocket protocol provides some advantages over the traditional HTTP protocol.&nbsp; Once the connection has been established, there is a point to point system of communication where both devices can communicate with one another simultaneously.&nbsp; This enables server sent events without using a work around like Comet or Long Polling.&nbsp; While these technologies work well, they carry the overhead of HTTP, whereas WebSocket frames have a wire-level overhead of as little as two bytes per frame.&nbsp; The full-duplex communication and low packet overhead make it an ideal protocol for real-time low latency experiences.<\/p>\n\n\n\n<p>An important note:\u00a0 The WebSocket protocol is not layered on top of HTTP, nor is it an extension of the HTTP protocol.\u00a0 The WebSocket protocol is a light weight protocol layered onto of TCP.\u00a0 The only part HTTP plays is in establishing a WebSocket connection via the HTTP Upgrade request.\u00a0 Also the HTTP Upgrade request is not specific to WebSockets but can be used to support other hand-shakes or upgrade mechanisms which will use the underlying TCP connection.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Open a WebSocket Connection<\/strong><\/h2>\n\n\n\n<p>A client can establish a WebSocket connection by initiating a client handshake request.&nbsp; As mentioned above the HTTP Upgrade request is used to initiate a WebSocket connection.<\/p>\n\n\n\n<p><code>GET \/chat HTTP\/1.1<br>HOST: server.example.com<br>Upgrade: websocket<br>Connection: Upgrade<br>Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==<br>Origin: http:\/\/example.com<br>Sec-WebSocket-Protocol: chat, superchat<br>Sec-WebSocket-Version: 13<\/code><\/p>\n\n\n\n<p>If all goes well on the server and the request can be accepted then the server handshake will be returned.<\/p>\n\n\n\n<p><code>HTTP\/1.1 101 Switching Protocols<br>Upgrade: websocket<br>Connection: Upgrade<br>Sec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo=<\/code><\/p>\n\n\n\n<p>If an error occurs and the server cannot accept the request, than a HTTP 500 should be returned to indicate that the request has failed and that the protocol is still HTTP.<\/p>\n\n\n\n<p>Once the client server handshake is completed the TCP connection used to make the initial HTTP request has now been upgraded to a WebSocket connection.&nbsp; Messages can now be sent from either the client to the server or the server to the client.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Code<\/strong><\/h3>\n\n\n\n<p>As a developer most of the nuances of the WebSocket handshake are hidden away by the platform specific APIs and SDKs.\u00a0 In the .NET world Windows 8 and Windows Server 2012 introduced native support for the WebSocket protocol. \u00a0In addition Internet Explorer 10 introduced native support for the WebSocket protocol as well. Also a variety of other platforms\u00a0support WebSockets.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Client<\/h4>\n\n\n\n<p>Using the .NET 4.5 Framework the client code to establish a WebSocket connection in C# would look like this. ClientWebSocket webSocket = null; webSocket = new ClientWebSocket(); await webSocket.ConnectAsync(new Uri(&#8220;ws:\/\/localhost\/Echo&#8221;), CancellationToken.None);<\/p>\n\n\n\n<p>Once the connection succeeds on the client the ClientWebSocket object can be used to receive and send messages.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Server<\/h4>\n\n\n\n<p>Using the .Net 4.5 Framework on a simple server using HttpListener, the C# code to accept a WebSocket request and complete the hand-shake would look like this. HttpListenerContext listenerContext = await httpListener.GetContextAsync(); if (listenerContext.Request.IsWebSocketRequest) { WebSocketContext webSocketContext = await listenerContext.AcceptWebSocketAsync(); WebSocket webSocket = webSocketContext.WebSocket } else { \/\/Return a 426 &#8211; Upgrade Required Status Code listenerContext.Response.StatusCode = 426; listenerContext.Response.Close(); }<\/p>\n\n\n\n<p>The call to AcceptWebSocket request returns after the server handshake has been returned to the client.&nbsp; At this point the <a href=\"https:\/\/web.archive.org\/web\/20220123113759\/http:\/\/msdn.microsoft.com\/en-us\/library\/system.net.websockets.websocket(v=vs.110).aspx\" target=\"_blank\" rel=\"noreferrer noopener\">WebSocket<\/a> object can be used to send and receive messages.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>WebSocket Messages<\/strong><\/h2>\n\n\n\n<p>WebSocket messages are transmitted in \u201cframes.\u201d&nbsp; Each WebSocket frame has an opcode, a payload length, and the payload data.&nbsp; Each frame has a header.&nbsp; The size of the header is between 2-14 bytes.&nbsp; As you can see the header overhead is much smaller than the text based HTTP headers.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">&nbsp;<strong>Headers<\/strong><\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>0<\/td><td>1<\/td><td>2<\/td><td>3<\/td><td>4<\/td><td>5<\/td><td>6<\/td><td>7<\/td><td>8<\/td><td>9<\/td><td>A<\/td><td>B<\/td><td>C<\/td><td>D<\/td><td>E<\/td><td>F<\/td><\/tr><tr><td>Final<\/td><td colspan=\"3\">Reserved Bits<\/td><td colspan=\"4\">OpCode<\/td><td>Mask<\/td><td colspan=\"7\">Payload Indicator<\/td><\/tr><tr><td colspan=\"16\">Extended payload length ( present if payload is longer than 125 bytes )<\/td><\/tr><tr><td colspan=\"16\">Extended payload length&nbsp; ( present if payload length is &gt;= 2^16 )<\/td><\/tr><tr><td colspan=\"16\">Extended payload length&nbsp; ( present if payload length is &gt;= 2^16 )<\/td><\/tr><tr><td colspan=\"16\">Extended payload length&nbsp; ( present if payload length is &gt;= 2^16 )<\/td><\/tr><tr><td colspan=\"16\">MaskingKey ( present if masking bit is set )<\/td><\/tr><tr><td colspan=\"16\">MaskingKey ( present if masking bit is set )<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>The first 9 bits sent in every WebSocket frame are defined as follow<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Final Bit<\/strong> (1 bit) \u2013 Indicates whether the frame is the final fragment of a message, as a large message can be broken up and sent over multiple frames.&nbsp; A message that is one frame long would also set this bit to 1.<\/li>\n\n\n\n<li><strong>Reserved<\/strong> (3 bits) \u2013 These must be 0, and are currently reserved for extensions.<\/li>\n\n\n\n<li><strong>OpCodes<\/strong> (4 bits) \u2013 Opcodes define how the payload data should be interpreted<\/li>\n\n\n\n<li><strong>Masking<\/strong> (1 bit) \u2013 Indicates if the payload data is masked.&nbsp; The WebSocket protocol specifies that all messages sent from a client to a server must be XOR masked.<\/li>\n<\/ul>\n\n\n\n<p>The variable length of a WebSocket header is based on the size of the payload and the masking-key<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Payload Length<\/strong> (7 bits, 7 + 16 bits, 7 + 64 bits) \u2013 Bits 10-16 of the header are the payload indicator bits.\u00a0The number of bits used to encode the payload length varies based on the size of the payload data.\n<ul class=\"wp-block-list\">\n<li><strong>0-125 bytes<\/strong>: payload length encoded in the payload indicator bits<\/li>\n\n\n\n<li><strong>126 \u2013 65,535 bytes<\/strong>: The payload indicator bits are set to 126, and the next two bytes are used to encode the payload length.<\/li>\n\n\n\n<li><strong>&gt;65,535 bytes:<\/strong> 127 is encoded in the payload indicator bits, and the next 8 bytes are used to specify the payload length.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Masking-key<\/strong> (0 or 16 bits) \u2013 If the masking bit is set, then the 32 bit integer used to Mask the payload is specified in this field.&nbsp; If the masking bit is not set than this is omitted.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">&nbsp;<strong>OpCodes<\/strong><\/h3>\n\n\n\n<p>The following table below defines WebSocket frame OpCodes.&nbsp; Applications should only set the Text or Binary OpCodes to specify how the payload data in the frame is interpreted.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Code<\/strong><\/th><th><strong>Meaning<\/strong><\/th><th><strong>Description<\/strong><\/th><\/tr><\/thead><tbody><tr><td>0x0<\/td><td>Continuation Frame<\/td><td>The payload in this frame is a continuation of the message sent in a previous frame that did not have its final bit set<\/td><\/tr><tr><td>0x1<\/td><td>Text Frame<\/td><td>Application Specific \u2013 The payload is encoded in UTF-8<\/td><\/tr><tr><td>0x2<\/td><td>Binary Frame<\/td><td>Application Specific \u2013 The payload is a binary blob<\/td><\/tr><tr><td>0x8<\/td><td>Close Connection Frame<\/td><td>Specifies that the WebSocket connection should be closed<\/td><\/tr><tr><td>0x9<\/td><td>Ping Frame<\/td><td>Protocol Specific \u2013 sent to check that the client is still available<\/td><\/tr><tr><td>0xA<\/td><td>Pong Frame<\/td><td>Protocol Specific \u2013 response sent after receiving a ping frame.&nbsp; Unsolicited pong messages can also be sent.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Code<\/h3>\n\n\n\n<p>Sending and receiving WebSocket messages is easy using the .NET Framework APIs.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Receiving a Message<\/h4>\n\n\n\n<p>byte[] receiveBuffer = new byte[receiveBufferLength]; while (webSocket.State == WebSocketState.Open) { WebSocketReceiveResult receiveResult = await webSocket.ReceiveAsync(new ArraySegment&lt;byte&gt;(receiveBuffer), CancellationToken.None); }<\/p>\n\n\n\n<p>The WebSocketReceiveResult object contains the information sent in one WebSocket frame including the OpCode, Final Bit Setting, \u00a0Payload Length, and CloseStatus &amp; Reason if its a Close Connection Frame. \u00a0The receiveBuffer will be populated with the data sent in the payload.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Sending a Message<\/h4>\n\n\n\n<p>Sending a message is also simple and an Async method is provided in the .NET 4.5 Framework. &nbsp;The code below echos the message received back over the channel. &nbsp;The data, Message Type, and Final Bit are specified in the parameter list. await webSocket.SendAsync(new ArraySegment&lt;byte&gt;(receiveBuffer, 0, receiveResult.Count), WebSocketMessageType.Binary, receiveResult.EndOfMessage)<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Close a WebSocket Connection<\/strong><\/h2>\n\n\n\n<p>Either endpoint can close the WebSocket connection.&nbsp; In order to do this the endpoint starts the WebSocket Closing Handshake.&nbsp; The initiating end point sends a WebSocket message with a closing status code, and an optional close reason (text), and sets the Opcode in the message to the Close Connection Frame (0x8).&nbsp; Once the message is sent the endpoint will close the WebSocket connection by closing the underlying TCP connection.<\/p>\n\n\n\n<p>As an application developer it is important to note that either endpoint, server or client, can initiate the closing handshake.&nbsp; Practically this means both endpoints need to handle receiving the close frame.&nbsp; It also means that some messages may not be delivered, if the connection is closed while the messages are in transit.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Connection Close Code<\/strong><\/h3>\n\n\n\n<p>Connection Close frames should include a status code, which indicates the reason the WebSocket connection was closed.&nbsp; These are somewhat analogous to HTTP Status Codes.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Code<\/th><th>Definition<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>1000<\/td><td>Normal Closure<\/td><td>The purpose for which the connection was established has been fulfilled<\/td><\/tr><tr><td>1001<\/td><td>Endpoint Unavailable<\/td><td>A server is going down, or a browser has navigated away from a page<\/td><\/tr><tr><td>1002<\/td><td>Protocol Error<\/td><td>The endpoint received a frame that violated the WebSocket protocol<\/td><\/tr><tr><td>1003<\/td><td>Invalid Message Type<\/td><td>The endpoint has received data that it does not understand.&nbsp; Endpoints which only understand text may send this if they receive a binary message and vice versa<\/td><\/tr><tr><td>1004 -1006<\/td><td>Reserved<\/td><td>Reserved for future use<\/td><\/tr><tr><td>1007<\/td><td>Invalid Payload Data<\/td><td>The payload contained data that was not consistent with the type of message<\/td><\/tr><tr><td>1008<\/td><td>Policy Violation<\/td><td>Endpoint received a message that violates its policy<\/td><\/tr><tr><td>1009<\/td><td>Message Too Big<\/td><td>Endpoint received a message that is too big for it to process.<\/td><\/tr><tr><td>1010<\/td><td>Mandatory Extension<\/td><td>An endpoint is terminating the connection because it expected to negotiate one or more extensions<\/td><\/tr><tr><td>1011<\/td><td>Internal Error<\/td><td>The server is terminating the connection because it encountered and unexpected error<\/td><\/tr><tr><td>1015<\/td><td>TLS Handshake<\/td><td>Used to designate that the connection closed because the TLS handshake failed.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Connection Close Code Ranges<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Code<\/th><th>Definition<\/th><\/tr><\/thead><tbody><tr><td>0-999<\/td><td>Not Used<\/td><\/tr><tr><td>1000-2999<\/td><td>Reserved for use by Protocol Definition<\/td><\/tr><tr><td>3000-3999<\/td><td>Reserved for use by libraries, frameworks &amp; applications.\u00a0 These should be registered with IANA<\/td><\/tr><tr><td>4000-4999<\/td><td>Reserved for private use and can\u2019t be registered.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">&nbsp;Code<\/h3>\n\n\n\n<p>Once again most of the details are dealt with by WebSocket libraries in your framework of choice.&nbsp; Application developers must decide when the connection should be closed, should set the appropriate connection close code and may also set a connection close reason.<\/p>\n\n\n\n<p>The .Net Framework makes this very easy, by providing an asynchronous method, which takes in the connection close code, and close reason as parameters. await webSocket.CloseAsync(WebSocketCloseStatus.NormalClosure, &#8220;Normal Closure&#8221;, CancellationToken.None);<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Microsoft WebSocket Implementations<\/h2>\n\n\n\n<p>As mentioned before\u00a0Windows 8 and Windows Server 2012 introduced native support for the WebSocket protocol. \u00a0Also because the Xbox One is running a variant of the Windows 8 operating system it also has built in support for WebSockets.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">.Net 4.5<\/h3>\n\n\n\n<p>Version 4.5 of the .NET framework introduced support for WebSockets through the System.Net.WebSockets namespace.\u00a0 The underlying connection is passing through HTTP.sys in the kernel so timeout settings in the HTTP.sys layer might still apply.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">WinRT<\/h3>\n\n\n\n<p>WinRT only exposes APIs for creating a WebSocket client connection.\u00a0 There are two classes to do this in the Windows.Networking.Sockets namespace, MessageWebSocket &amp; StreamWebSocket.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">&nbsp;Win32 (WinHTTP)<\/h3>\n\n\n\n<p>The WinRT API is also available to C++ developers.&nbsp; For developers that want more control WinHTTP provides a set of APIs for sending&nbsp; WebSocket upgrade request, and sending and receiving data on WebSocket connections.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">&nbsp;JavaScript<\/h3>\n\n\n\n<p>All the latest versions of common browsers, with the exception of Android, support the WebSocket protocol and API as defined by the W3C.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">SignalR<\/h3>\n\n\n\n<p>The ASP.NET team has built a high-level bi-directional communication API called<a href=\"https:\/\/web.archive.org\/web\/20220123113759\/http:\/\/signalr.net\/\" target=\"_blank\" rel=\"noreferrer noopener\"> SignalR<\/a>.&nbsp; Under the hood SignalR picks the best protocol to use based on the capabilities of the clients.&nbsp; If WebSockets are available it prefers to use that protocol, otherwise it falls back to other HTTP techniques like Comet and Long Polling.&nbsp; SignalR has support for multiple languages including .NET, Javascript, and iOS and Android via Xamarin.&nbsp; It is an open source project on GitHub.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Conclusion<\/h2>\n\n\n\n<p>WebSockets are a great new protocol to power real time applications and reactive user experiences due to its lightweight headers, and bi-directional communication.&nbsp; It is also a great protocol for implementing Pub\/Sub messaging patterns between servers and clients.&nbsp; However WebSockets are not a silver bullet for networked communications.&nbsp; WebSockets are incredibly powerful but do also have their drawbacks.&nbsp; For instance because WebSockets require a persistent connection, they are consuming resources on the server and require the server to manage state.&nbsp; HTTP and RESTful APIs are still incredibly useful and valid in many scenarios and developers should consider the uses of their APIs and applications when choosing which protocol to use.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Over the past year, prior to leaving 343, I spent a large amount of time working with the WebSockets protocol and upgrading the Halo Services to support it.\u00a0 In order to solidify my knowledge and provide a handy refresher for when this information invariably gets context switched out of my&#8230;<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4],"tags":[],"class_list":["post-38","post","type-post","status-publish","format-standard","hentry","category-tech-insights"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v21.6 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>A WebSocket Primer - caitiem.com<\/title>\n<meta name=\"description\" content=\"Over the past year, prior to leaving 343, I spent a large amount of time working with the WebSockets protocol and upgrading the Halo Services to support it.\u00a0 In order to solidify my knowledge and provide a handy refresher for when this information invariably gets context switched out of my brain in the future, I decided to write a primer on WebSockets.\u00a0 Hopefully other people will find the introduction to this new protocol useful as well.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"http:\/\/www.caitiem.com\/2013\/12\/02\/a-websocket-primer\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"A WebSocket Primer - caitiem.com\" \/>\n<meta property=\"og:description\" content=\"Over the past year, prior to leaving 343, I spent a large amount of time working with the WebSockets protocol and upgrading the Halo Services to support it.\u00a0 In order to solidify my knowledge and provide a handy refresher for when this information invariably gets context switched out of my brain in the future, I decided to write a primer on WebSockets.\u00a0 Hopefully other people will find the introduction to this new protocol useful as well.\" \/>\n<meta property=\"og:url\" content=\"http:\/\/www.caitiem.com\/2013\/12\/02\/a-websocket-primer\/\" \/>\n<meta property=\"og:site_name\" content=\"caitiem.com\" \/>\n<meta property=\"article:published_time\" content=\"2024-02-13T11:17:10+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2024-02-13T12:28:35+00:00\" \/>\n<meta name=\"author\" content=\"caiti335\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"caiti335\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"9 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"http:\/\/www.caitiem.com\/2013\/12\/02\/a-websocket-primer\/\",\"url\":\"http:\/\/www.caitiem.com\/2013\/12\/02\/a-websocket-primer\/\",\"name\":\"A WebSocket Primer - caitiem.com\",\"isPartOf\":{\"@id\":\"https:\/\/www.caitiem.com\/#website\"},\"datePublished\":\"2024-02-13T11:17:10+00:00\",\"dateModified\":\"2024-02-13T12:28:35+00:00\",\"author\":{\"@id\":\"https:\/\/www.caitiem.com\/#\/schema\/person\/0ea20eb328afb663a23dc72ebeced8c0\"},\"description\":\"Over the past year, prior to leaving 343, I spent a large amount of time working with the WebSockets protocol and upgrading the Halo Services to support it.\u00a0 In order to solidify my knowledge and provide a handy refresher for when this information invariably gets context switched out of my brain in the future, I decided to write a primer on WebSockets.\u00a0 Hopefully other people will find the introduction to this new protocol useful as well.\",\"breadcrumb\":{\"@id\":\"http:\/\/www.caitiem.com\/2013\/12\/02\/a-websocket-primer\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"http:\/\/www.caitiem.com\/2013\/12\/02\/a-websocket-primer\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"http:\/\/www.caitiem.com\/2013\/12\/02\/a-websocket-primer\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"\u0413\u043b\u0430\u0432\u043d\u0430\u044f \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430\",\"item\":\"http:\/\/www.caitiem.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"A WebSocket Primer\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.caitiem.com\/#website\",\"url\":\"https:\/\/www.caitiem.com\/\",\"name\":\"caitiem.com\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.caitiem.com\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.caitiem.com\/#\/schema\/person\/0ea20eb328afb663a23dc72ebeced8c0\",\"name\":\"caiti335\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.caitiem.com\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/08e6287ee41d891ed906aa45a965ba3c?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/08e6287ee41d891ed906aa45a965ba3c?s=96&d=mm&r=g\",\"caption\":\"caiti335\"},\"url\":\"https:\/\/www.caitiem.com\/author\/caiti335\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"A WebSocket Primer - caitiem.com","description":"Over the past year, prior to leaving 343, I spent a large amount of time working with the WebSockets protocol and upgrading the Halo Services to support it.\u00a0 In order to solidify my knowledge and provide a handy refresher for when this information invariably gets context switched out of my brain in the future, I decided to write a primer on WebSockets.\u00a0 Hopefully other people will find the introduction to this new protocol useful as well.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"http:\/\/www.caitiem.com\/2013\/12\/02\/a-websocket-primer\/","og_locale":"en_US","og_type":"article","og_title":"A WebSocket Primer - caitiem.com","og_description":"Over the past year, prior to leaving 343, I spent a large amount of time working with the WebSockets protocol and upgrading the Halo Services to support it.\u00a0 In order to solidify my knowledge and provide a handy refresher for when this information invariably gets context switched out of my brain in the future, I decided to write a primer on WebSockets.\u00a0 Hopefully other people will find the introduction to this new protocol useful as well.","og_url":"http:\/\/www.caitiem.com\/2013\/12\/02\/a-websocket-primer\/","og_site_name":"caitiem.com","article_published_time":"2024-02-13T11:17:10+00:00","article_modified_time":"2024-02-13T12:28:35+00:00","author":"caiti335","twitter_card":"summary_large_image","twitter_misc":{"Written by":"caiti335","Est. reading time":"9 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"http:\/\/www.caitiem.com\/2013\/12\/02\/a-websocket-primer\/","url":"http:\/\/www.caitiem.com\/2013\/12\/02\/a-websocket-primer\/","name":"A WebSocket Primer - caitiem.com","isPartOf":{"@id":"https:\/\/www.caitiem.com\/#website"},"datePublished":"2024-02-13T11:17:10+00:00","dateModified":"2024-02-13T12:28:35+00:00","author":{"@id":"https:\/\/www.caitiem.com\/#\/schema\/person\/0ea20eb328afb663a23dc72ebeced8c0"},"description":"Over the past year, prior to leaving 343, I spent a large amount of time working with the WebSockets protocol and upgrading the Halo Services to support it.\u00a0 In order to solidify my knowledge and provide a handy refresher for when this information invariably gets context switched out of my brain in the future, I decided to write a primer on WebSockets.\u00a0 Hopefully other people will find the introduction to this new protocol useful as well.","breadcrumb":{"@id":"http:\/\/www.caitiem.com\/2013\/12\/02\/a-websocket-primer\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["http:\/\/www.caitiem.com\/2013\/12\/02\/a-websocket-primer\/"]}]},{"@type":"BreadcrumbList","@id":"http:\/\/www.caitiem.com\/2013\/12\/02\/a-websocket-primer\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"\u0413\u043b\u0430\u0432\u043d\u0430\u044f \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430","item":"http:\/\/www.caitiem.com\/"},{"@type":"ListItem","position":2,"name":"A WebSocket Primer"}]},{"@type":"WebSite","@id":"https:\/\/www.caitiem.com\/#website","url":"https:\/\/www.caitiem.com\/","name":"caitiem.com","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.caitiem.com\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.caitiem.com\/#\/schema\/person\/0ea20eb328afb663a23dc72ebeced8c0","name":"caiti335","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.caitiem.com\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/08e6287ee41d891ed906aa45a965ba3c?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/08e6287ee41d891ed906aa45a965ba3c?s=96&d=mm&r=g","caption":"caiti335"},"url":"https:\/\/www.caitiem.com\/author\/caiti335\/"}]}},"_links":{"self":[{"href":"https:\/\/www.caitiem.com\/wp-json\/wp\/v2\/posts\/38","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.caitiem.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.caitiem.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.caitiem.com\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.caitiem.com\/wp-json\/wp\/v2\/comments?post=38"}],"version-history":[{"count":1,"href":"https:\/\/www.caitiem.com\/wp-json\/wp\/v2\/posts\/38\/revisions"}],"predecessor-version":[{"id":45,"href":"https:\/\/www.caitiem.com\/wp-json\/wp\/v2\/posts\/38\/revisions\/45"}],"wp:attachment":[{"href":"https:\/\/www.caitiem.com\/wp-json\/wp\/v2\/media?parent=38"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.caitiem.com\/wp-json\/wp\/v2\/categories?post=38"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.caitiem.com\/wp-json\/wp\/v2\/tags?post=38"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}