FileReaderSync: readAsText() 方法

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

readAsText() 方法是 FileReaderSync 接口的一种方法，它允许以同步方式将 File 或 Blob 对象读入字符串。此接口 仅在 worker 中可用，因为它支持可能导致阻塞的同步 I/O。

语法

js
readAsText(blob)
readAsText(blob, encoding)

参数

blob

要读取的 File 或 Blob。

encoding 可选

可选参数指定要使用的编码（例如，iso-8859-1 或 UTF-8）。如果不存在，该方法将应用检测算法。

返回值

表示输入数据的字符串。

异常

此方法可能会引发以下异常

NotFoundError DOMException

如果 DOM File 或 Blob 表示的资源无法找到，则会抛出此异常，例如，该资源已被删除。

SecurityError DOMException

如果检测到以下问题情况之一，则会抛出此异常

  • 资源已被第三方修改；
  • 同时执行了太多读取操作；
  • 资源指向的文件对于 Web 使用来说不安全（例如，它是系统文件）。
NotReadableError DOMException

如果由于权限问题（例如并发锁定）导致无法读取资源，则会抛出此异常。

EncodingError DOMException

如果资源是数据 URL 且超过每个浏览器定义的限制长度，则会抛出此异常。

规范

规范
文件 API
# readAsTextSync

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅