FileReaderSync: readAsArrayBuffer() 方法

Baseline 已廣泛支援

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

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

FileReaderSync 介面的 readAsArrayBuffer() 方法允許以同步方式將 FileBlob 物件讀取到一個 ArrayBuffer 中。該介面 僅在 worker 中可用,因為它支援可能阻塞的同步 I/O。

語法

js
readAsArrayBuffer(blob)

引數

blob

要讀取到 FileArrayBuffer 中的 FileBlob

返回值

一個 ArrayBuffer,代表檔案的資料。

異常

此方法可能引發以下異常

NotFoundError DOMException

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

SecurityError DOMException

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

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

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

EncodingError DOMException

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

規範

規範
File API
# readAsArrayBufferSyncSection

瀏覽器相容性

另見