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)。如果不存在,该方法将对其应用检测算法以确定其编码。
- : 此可选参数指定要使用的编码(例如
返回值
表示输入数据的字符串。
异常
此方法可能引发以下异常:
NotFoundErrorDOMException- : 如果无法找到 DOM File 或 Blob 对象表示的资源,例如因为它已被删除,则抛出该异常。
SecurityErrorDOMException- : 如果检测到以下有问题的情况之一,则抛出该异常:
- 资源已被第三方修改;
- 同时执行太多读取;
- 资源指向的文件对于从 Web 上使用来说是不安全的(比如它是系统文件)。
- : 如果检测到以下有问题的情况之一,则抛出该异常:
NotReadableErrorDOMException- : 如果由于权限问题(例如并发锁)而无法读取资源,则抛出该异常。
EncodingErrorDOMException- : 如果资源是 data URL 并且超出每个浏览器定义的限制长度,则抛出该异常。
规范
浏览器兼容性
参见
- 文件 API
- File
- FileReaderSync
- FileReader
- Blob
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
