FileReaderSync: readAsDataURL() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

注意:此功能僅在 Web Workers 中可用,Service Workers 除外。

FileReaderSync 介面的 readAsDataURL() 方法允許以同步方式讀取 FileBlob 物件,並將其作為資料 URL 字串返回。此介面 僅在 Worker 中可用,因為它支援可能阻塞的同步 I/O。

語法

js
readAsDataURL(blob)

引數

blob

要讀取的 FileBlob

返回值

作為資料 URL 表示輸入資料的字串。

異常

此方法可能引發以下異常

NotFoundError DOMException

如果 DOM FileBlob 所表示的資源找不到(例如,因為它已被刪除),則丟擲此錯誤。

SecurityError DOMException

如果檢測到以下任何一種問題情況,則丟擲此錯誤:

  • 資源已被第三方修改;
  • 同時執行了過多的讀取操作;
  • 資源指向的檔案不適合 Web 使用(例如,它是系統檔案)。
NotReadableError DOMException

如果由於許可權問題(如併發鎖定)導致無法讀取資源,則丟擲此錯誤。

EncodingError DOMException

如果資源是資料 URL 並且超過了每個瀏覽器定義的長度限制,則丟擲此錯誤。

規範

規範
File API
# readAsDataURLSync-section

瀏覽器相容性

另見