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 貢獻者編輯。