URL.createObjectURL()

URL.createObjectURL() 静的メソッドは、引数で指定されたオブジェクトを表す URL を含む DOMString を生成します。 URL の寿命は、それを作成したウィンドウ内の document と結び付けられています。 新しいオブジェクト URL は、指定された File オブジェクトか Blob オブジェクトを表します。

オブジェクト URL を開放するには、 revokeObjectURL() を呼び出してください。

構文

objectURL = URL.createObjectURL(object);

引数

object

オブジェクト URL を生成するための File, Blob, MediaSource の何れかのオブジェクトです。

返値

object で指定された内容を参照するために使用されるオブジェクト URL を含んだ DOMString です。

例

オブジェクト URL で画像を表示を参照してください。

使用上のメモ

メモリ管理

すでにオブジェクト URL が生成されている場合でも、 createObjectURL() を呼び出す度に、新しいオブジェクト URL が生成されます。 必要がなくなったら URL.revokeObjectURL() を呼び出して、それぞれを解放してください。

ブラウザーは、文書がアンロードされた際にこれらのオブジェクト URL をメモリから解放します。 しかし、性能とメモリ使用を考慮すると、明示的にアンロードできる安全な機会があるならば、そうするべきです。

メディアストリームのオブジェクト URL の使用

古いバージョンの Media Source 仕様書では、 <video> 要素にストリームを添付するには MediaStream にオブジェクト URL を生成する必要があるとしてます。 これはもう必要なく、ブラウザーはこのようにする対応を削除してきています。

仕様書

ブラウザーの対応

このページの互換性一覧表は構造化データから生成されています。データに協力したいのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。

関連情報

• Web アプリケーションからファイルを扱う
• オブジェクト URL で画像を表示
• URL.revokeObjectURL()
• HTMLMediaElement.srcObject
• FileReader.readAsDataURL()