[ABANDONED] WebSocket Blob receive in the browser process: renderer changes

third_party/WebKit/Source/modules/websockets/WebSocketChannel.h

 /*
  * Copyright (C) 2009 Google Inc.  All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 52 matching lines @@
         CloseEventCodeInvalidFramePayloadData = 1007,
         CloseEventCodePolicyViolation = 1008,
         CloseEventCodeMessageTooBig = 1009,
         CloseEventCodeMandatoryExt = 1010,
         CloseEventCodeInternalError = 1011,
         CloseEventCodeTLSHandshake = 1015,
         CloseEventCodeMinimumUserDefined = 3000,
         CloseEventCodeMaximumUserDefined = 4999
     };
 
+    enum BinaryType {
+        BinaryTypeBlob,
+        BinaryTypeArrayBuffer,
+    };
+
     virtual bool connect(const KURL&, const String& protocol) = 0;
     virtual void send(const CString&) = 0;
     virtual void send(const DOMArrayBuffer&, unsigned byteOffset, unsigned byteLength) = 0;
     virtual void send(PassRefPtr<BlobDataHandle>) = 0;
 
     // For WorkerWebSocketChannel.
     virtual void sendTextAsCharVector(PassOwnPtr<Vector<char>>) = 0;
     virtual void sendBinaryAsCharVector(PassOwnPtr<Vector<char>>) = 0;
 
     // Do not call |send| after calling this method.
     virtual void close(int code, const String& reason) = 0;
 
+    // Change binary mode. This controls whether didReceiveArrayBuffer or didReceiveBlob is called in responnse to a
+    // binary message. The effect is not instant, so the WebSocketChannelClient has to be prepared to receive a Blob
+    // even after changing binary type to ArrayBuffer, and vice-versa.
+    virtual void changeBinaryType(BinaryType) = 0;
+
     // Log the reason text and close the connection. Will call didClose().
     // The MessageLevel parameter will be used for the level of the message
     // shown at the devtool console.
     // sourceURL and lineNumber parameters may be shown with the reason text
     // at the devtool console.
     // Even if sourceURL and lineNumber are specified, they may be ignored
     // and the "current" url and the line number in the sense of
     // JavaScript execution may be shown if this method is called in
     // a JS execution context.
     // You can specify String() and 0 for sourceURL and lineNumber
     // respectively, if you can't / needn't provide the information.
     virtual void fail(const String& reason, MessageLevel, const String& sourceURL, unsigned lineNumber) = 0;
 
     // Do not call any methods after calling this method.
     virtual void disconnect() = 0; // Will suppress didClose().
 
     virtual ~WebSocketChannel() { }
 
     DEFINE_INLINE_VIRTUAL_TRACE() { }
 };
 
 } // namespace blink
 
 #endif // WebSocketChannel_h