大网数据广告活动
Web 标准与前端开发

FileReaderSync:readAsText() 方法

· 52CE 我爱测

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

File API worker_except_service

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

语法

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
    • : 如果资源是 data URL 并且超出每个浏览器定义的限制长度,则抛出该异常。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。