WebSocket Mojo API: set reason when disconnecting a WebSocket interface because of insufficient res…

third_party/WebKit/public/platform/modules/websockets/websocket.mojom

 // Copyright 2016 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 module blink.mojom;
 
 import "url/mojo/origin.mojom";
 import "url/mojo/url.mojom";
 
 enum WebSocketMessageType {
@@ skipping 78 matching lines @@
   // - If |was_clean| is false, then the WebSocket connection was not closed
   //   cleanly.
   OnDropChannel(bool was_clean, uint16 code, string reason);
 
   // Notify the renderer that a closing handshake has been initiated by the
   // server, so that it can set the Javascript readyState to CLOSING.
   OnClosingHandshake();
 };
 
 interface WebSocket {
+  // The client side may observe the following disconnection reason from the
+  // service side:
+  const uint32 kInsufficientResources = 1;
+
   // Open new WebSocket connection to |socket_url|. |requested_protocols| is a
   // list of tokens identifying sub-protocols the renderer would like to use,
   // as described in RFC6455 "Subprotocols Using the WebSocket Protocol".
   AddChannelRequest(url.mojom.Url url,
                     array<string> requested_protocols,
                     url.mojom.Origin origin,
                     url.mojom.Url first_party_for_cookies,
                     string user_agent_override,
                     WebSocketClient client);
 
@@ skipping 20 matching lines @@
   //
   // When sent by the renderer, this will cause a Close message will be sent and
   // the TCP/IP connection will be closed.
   //
   // - |code| is one of the reason codes specified in RFC6455.
   // - |reason|, if non-empty, is a UTF-8 encoded string which may be useful for
   //   debugging but is not necessarily human-readable, as supplied by the
   //   server in the Close message.
   StartClosingHandshake(uint16 code, string reason);
 };