XMLHttpRequest.sendAsBinary()

The obsolete XMLHttpRequest method sendAsBinary() is a variant of the send() method that sends binary data. The send() method now supports binary data and should now be used instead.

This method makes it possible to read and upload any type of file and to stringify the raw data.

Syntax

XMLHttpRequest.sendAsBinary(binaryString);

Parameters

binaryString

A DOMString which encodes the binary content to be sent. You can create the binary string using the FileReader method readAsBinaryString(). The string is converted to binary for transfer by removing the high-order byte of each character.

Return value

undefined.

Polyfill

Since sendAsBinary() is an experimental feature, here is a polyfill for browsers that don't support the sendAsBinary() method but support typed arrays.

/*\
|*|
|*|  :: XMLHttpRequest.prototype.sendAsBinary() Polyfill ::
|*|
|*|  https://developer.mozilla.org/en-US/docs/DOM/XMLHttpRequest#sendAsBinary()
|*|
\*/

if (!XMLHttpRequest.prototype.sendAsBinary) {
  XMLHttpRequest.prototype.sendAsBinary = function (sData) {
    var nBytes = sData.length, ui8Data = new Uint8Array(nBytes);
    for (var nIdx = 0; nIdx < nBytes; nIdx++) {
      ui8Data[nIdx] = sData.charCodeAt(nIdx) & 0xff;
    }
    /* send as ArrayBufferView...: */
    this.send(ui8Data);
    /* ...or as ArrayBuffer (legacy)...: this.send(ui8Data.buffer); */
  };
}

Browser compatibility

• Using XMLHttpRequest