このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

FileReaderSync: readAsDataURL() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.

readAsDataURL()FileReaderSync インターフェイスのメソッドで、File または Blob オブジェクトを同期的に data URL を表す文字列に読み込むことができます。このインターフェイスは、ブロックが発生する可能性のある同期 I/O を可能にするため、ワーカーのみ利用可能です。

構文

js
readAsDataURL(File)
readAsDataURL(Blob)

引数

blob

読み込み対象の File または Blob です。

返値

入力データを data URL として表す文字列です。

例外

このメソッドでは以下の例外が発生する可能性があります。

NotFoundError DOMException

DOM の File または Blob で表されるリソースが、消去されたなどの理由で見つからない場合に発生します。

SecurityError DOMException

以下の問題のある状況のいずれかが検出された場合に発生します。

  • リソースが第三者によって変更されている
  • 同時に行われる読み取りが多すぎる
  • リソースが指しているファイルがウェブから利用するには安全ではない(システムファイルなど)
NotReadableError DOMException

同時実行ロックなどの権限の問題でリソースを読み込めない場合に発生します。

EncodingError DOMException

リソースが data URL であり、ブラウザーごとに定義された制限長を超えた場合に発生します。

仕様書

Specification
File API
# readAsDataURLSync-section

ブラウザーの互換性

関連情報