在此页

• 句法
• Polyfill
• 浏览器兼容性
• 相关话题

过时 XMLHttpRequest 方法 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.

警告： This method is obsolete and should not be used. You should instead simply use the send() method, which now supports binary data in various forms.

句法

XMLHttpRequest.sendAsBinary(binaryString);
					

参数

binaryString

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

返回值

undefined .

Polyfill

由于 sendAsBinary() is an experimental feature, here is a polyfill for browsers that don't 支持 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); */
  };
}
					

注意： It's possible to build this polyfill putting two types of data as argument for send() ： ArrayBuffer ( ui8Data.buffer – the commented code) or an ArrayBufferView ( ui8Data , which is a typed array of 8-bit unsigned integers – uncommented code). However, on Google Chrome, when you try to send an ArrayBuffer , the following warning message will appear: ArrayBuffer is deprecated in XMLHttpRequest.send(). Use ArrayBufferView instead. Another possible approach to send binary data is the StringView Non native typed arrays superclass in conjunction with the send() 方法。

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
sendAsBinary 弃用 非标	Chrome No 不支持 No 有 polyfill available to support sendAsBinary() .	Edge No 不支持 No 有 polyfill available to support sendAsBinary() .	Firefox 2 — 31	IE No	Opera No	Safari No	WebView Android No 不支持 No 有 polyfill available to support sendAsBinary() .	Chrome Android No 不支持 No 有 polyfill available to support sendAsBinary() .	Firefox Android 4 — 31	Opera Android No	Safari iOS No	Samsung Internet Android No 不支持 No 有 polyfill available to support sendAsBinary() .

图例

不支持

不支持

非标。预期跨浏览器支持较差。

非标。预期跨浏览器支持较差。

弃用。不要用于新网站。

弃用。不要用于新网站。

见实现注意事项。

• 使用 XMLHttpRequest

元数据

• 最后修改： 2019 年 3 月 23 日

相关话题

1. XMLHttpRequest
2. 构造函数

   1. XMLHttpRequest()
3. 特性

   1. channel
   2. mozAnon
   3. mozBackgroundRequest
   4. mozResponseArrayBuffer
   5. mozSystem
   6. multipart
   7. onreadystatechange
   8. readyState
   9. response
   10. responseText
   11. responseType
   12. responseURL
   13. responseXML
   14. status
   15. statusText
   16. timeout
   17. upload
   18. withCredentials
4. 方法

   1. abort()
   2. getAllResponseHeaders()
   3. getResponseHeader()
   4. open()
   5. openRequest()
   6. overrideMimeType()
   7. send()
   8. sendAsBinary()
   9. setRequestHeader()
5. 事件

   1. onreadystatechange
   2. abort
   3. error
   4. load
   5. loadend
   6. loadstart
   7. progress
   8. timeout
6. 继承：

   1. XMLHttpRequestEventTarget
   2. EventTarget
7. XMLHttpRequest 相关页面

   1. FormData
   2. XMLHttpRequestEventTarget
   3. XMLHttpRequestUpload