WebSocket Pepper API: allow to close connection without code and reason

ppapi/c/ppb_websocket.h

 /* Copyright (c) 2012 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.
  */
 
-/* From ppb_websocket.idl modified Wed Apr 25 11:48:30 2012. */
+/* From ppb_websocket.idl modified Tue May 15 18:32:39 2012. */
 
 #ifndef PPAPI_C_PPB_WEBSOCKET_H_
 #define PPAPI_C_PPB_WEBSOCKET_H_
 
 #include "ppapi/c/pp_bool.h"
 #include "ppapi/c/pp_completion_callback.h"
 #include "ppapi/c/pp_instance.h"
 #include "ppapi/c/pp_macros.h"
 #include "ppapi/c/pp_resource.h"
 #include "ppapi/c/pp_stdint.h"
@@ skipping 48 matching lines @@
  * GetCloseCode(). Refer to RFC 6455, The WebSocket Protocol, for further
  * information.
  * <code>PP_WEBSOCKETSTATUSCODE_NORMAL_CLOSURE</code> and codes in the range
  * <code>PP_WEBSOCKETSTATUSCODE_USER_REGISTERED_MIN</code> to
  * <code>PP_WEBSOCKETSTATUSCODE_USER_REGISTERED_MAX</code>, and
  * <code>PP_WEBSOCKETSTATUSCODE_USER_PRIVATE_MIN</code> to
  * <code>PP_WEBSOCKETSTATUSCODE_USER_PRIVATE_MAX</code> are valid for Close().
  */
 typedef enum {
   /**
+   * Indicates to request closing connection without status code. This code is
+   * internally assigned in WebKit, and not based on any WebSocket related
+   * specification.
+   */
+  PP_WEBSOCKETSTATUSCODE_NOT_SPECIFIED = -1,
+  /**
    * Status codes in the range 0-999 are not used.
    */
   /**
    * Indicates a normal closure.
    */
   PP_WEBSOCKETSTATUSCODE_NORMAL_CLOSURE = 1000,
   /**
    * Indicates that an endpoint is "going away", such as a server going down.
    */
   PP_WEBSOCKETSTATUSCODE_GOING_AWAY = 1001,
@@ skipping 65 matching lines @@
    * IANA.
    */
   PP_WEBSOCKETSTATUSCODE_USER_REGISTERED_MIN = 3000,
   PP_WEBSOCKETSTATUSCODE_USER_REGISTERED_MAX = 3999,
   /**
    * Status codes in the range 4000-4999 are reserved for private use.
    * Application can use these codes for application specific purposes freely.
    */
   PP_WEBSOCKETSTATUSCODE_USER_PRIVATE_MIN = 4000,
   PP_WEBSOCKETSTATUSCODE_USER_PRIVATE_MAX = 4999
-} PP_WebSocketCloseCode;
-PP_COMPILE_ASSERT_SIZE_IN_BYTES(PP_WebSocketCloseCode, 4);
+} PP_WebSocketStatusCode;
+PP_COMPILE_ASSERT_SIZE_IN_BYTES(PP_WebSocketStatusCode, 4);
 /**
  * @}
  */
 
 /**
  * @addtogroup Interfaces
  * @{
  */
 /**
  * The <code>PPB_WebSocket</code> interface provides bi-directional,
@@ skipping 67 matching lines @@
                      const struct PP_Var protocols[],
                      uint32_t protocol_count,
                      struct PP_CompletionCallback callback);
   /**
    * Close() closes the specified WebSocket connection by specifying
    * <code>code</code> and <code>reason</code>.
    *
    * @param[in] web_socket A <code>PP_Resource</code> corresponding to a
    * WebSocket.
    *
-   * @param[in] code The WebSocket close code. This is ignored if it is 0.
+   * @param[in] code The WebSocket close code. This is ignored if it is
+   * <code>PP_WEBSOCKETSTATUSCODE_NOT_SPECIFIED</code>.
    * <code>PP_WEBSOCKETSTATUSCODE_NORMAL_CLOSURE</code> must be used for the
    * usual case. To indicate some specific error cases, codes in the range
    * <code>PP_WEBSOCKETSTATUSCODE_USER_REGISTERED_MIN</code> to
    * <code>PP_WEBSOCKETSTATUSCODE_USER_REGISTERED_MAX</code>, and in the range
    * <code>PP_WEBSOCKETSTATUSCODE_USER_PRIVATE_MIN</code> to
    * <code>PP_WEBSOCKETSTATUSCODE_USER_PRIVATE_MAX</code> are available.
    *
    * @param[in] reason A <code>PP_Var</code> representing the WebSocket
    * close reason. This is ignored if it is <code>PP_VARTYPE_UNDEFINED</code>.
    * Otherwise, its <code>PP_VarType</code> must be
    * <code>PP_VARTYPE_STRING</code>.
    *
    * @param[in] callback A <code>PP_CompletionCallback</code> called
    * when the connection is closed or an error occurs in closing the
    * connection.
    *
    * @return An int32_t containing an error code from <code>pp_errors.h</code>.
    * Returns <code>PP_ERROR_BADARGUMENT</code> if <code>reason</code> contains
    * an invalid character as a UTF-8 string, or is longer than 123 bytes.
    * <code>PP_ERROR_BADARGUMENT</code> corresponds to a JavaScript SyntaxError
    * in the WebSocket API specification.
    * Returns <code>PP_ERROR_NOACCESS</code> if the code is not an integer
    * equal to 1000 or in the range 3000 to 4999. <code>PP_ERROR_NOACCESS</code>
    * corresponds to an InvalidAccessError in the WebSocket API specification.
    * Returns <code>PP_ERROR_INPROGRESS</code> if a previous call to Close() is
    * not finished.
    */
   int32_t (*Close)(PP_Resource web_socket,
-                   uint16_t code,
+                   PP_WebSocketStatusCode code,
                    struct PP_Var reason,
                    struct PP_CompletionCallback callback);
   /**
    * ReceiveMessage() receives a message from the WebSocket server.
    * This interface only returns a single message. That is, this interface must
    * be called at least N times to receive N messages, no matter the size of
    * each message.
    *
    * @param[in] web_socket A <code>PP_Resource</code> corresponding to a
    * WebSocket.
@@ skipping 136 matching lines @@
   struct PP_Var (*GetURL)(PP_Resource web_socket);
 };
 
 typedef struct PPB_WebSocket_1_0 PPB_WebSocket;
 /**
  * @}
  */
 
 #endif  /* PPAPI_C_PPB_WEBSOCKET_H_ */