FileReaderSync: readAsText() 方法

Baseline 已广泛支持

此特性已相当成熟，可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来，各浏览器均已提供此特性。

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

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

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

NotReadableError DOMException

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

EncodingError DOMException

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

规范
File API # readAsTextSync

此页面最后修改于 2025年4月3日，由 MDN 贡献者编辑。