FileReaderSync:readAsBinaryString() 方法

已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它,但也许已从相关的 web 标准中移除,也许正准备移除或出于兼容性而保留。请尽量不要使用该特性,并更新现有的代码;参见本页面底部的兼容性表格以指导你作出决定。请注意,该特性随时可能无法正常工作。

备注: 此特性仅在 Web Worker(不包括 Service Worker)中可用。

备注: 此方法已弃用,取而代之的是 readAsArrayBuffer()

FileReaderSync 接口的 readAsBinaryString() 方法允许以同步方式读取 FileBlob 对象并将其转换为字符串。此接口仅在 worker可用,因为它支持同步 I/O,可能导致潜在的阻塞。

语法

js
readAsBinaryString(blob)

参数

blob

要读取的 FileBlob 对象。

返回值

表示输入数据的字符串。

异常

NotFoundError DOMException

如果无法找到 DOM FileBlob 对象表示的资源,例如因为它已被删除,则抛出该异常。

SecurityError DOMException

如果检测到以下有问题的情况之一,则抛出该异常:

  • 资源已被第三方修改;
  • 同时执行太多读取;
  • 资源指向的文件对于从 Web 上使用来说是不安全的(比如它是系统文件)。
NotReadableError DOMException

如果由于权限问题(例如并发锁)而无法读取资源,则抛出该异常。

EncodingError DOMException

如果资源是 data URL 并且超出每个浏览器定义的限制长度,则抛出该异常。

规范

Specification
File API
# readAsBinaryStringSyncSection

浏览器兼容性

BCD tables only load in the browser

参见