FileReaderSync: readAsBinaryString() 方法

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

注意:此功能仅在 Web Workers 中可用,Service Workers 除外。

注意: 此方法已被弃用,请使用 readAsArrayBuffer() 替代。

readAsBinaryString() 方法属于 FileReaderSync 接口,它允许以同步方式将 FileBlob 对象读取到字符串中。该接口 仅在 Worker 中可用,因为它启用了可能阻塞的同步 I/O。

语法

js
readAsBinaryString(blob)

参数

blob

要读取的 FileBlob

返回值

表示输入数据的字符串。

异常

NotFoundError DOMException

如果 DOM FileBlob 所表示的资源找不到(例如,因为它已被删除),则抛出此错误。

SecurityError DOMException

如果检测到以下任何一种问题情况,则抛出此错误:

  • 资源已被第三方修改;
  • 同时执行的读取次数过多;
  • 资源指向的文件不适合 Web 使用(例如,它是系统文件)。
NotReadableError DOMException

如果由于权限问题(如并发锁定)导致无法读取资源,则抛出此错误。

EncodingError DOMException

如果资源是数据 URL 并且超过了每个浏览器定义的长度限制,则抛出此错误。

规范

规范
File API
# readAsBinaryStringSyncSection

浏览器兼容性

另见