このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
URL: createObjectURL() 静的メソッド
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月.
createObjectURL() はURL インターフェイスの静的メソッドで、引数で指定されたオブジェクトを表す URL を含む文字列を生成します。
URL の寿命は、それを作成したウィンドウ内のdocument と結び付けられています。 新しいオブジェクト URL は、指定されたFile オブジェクトかBlob オブジェクトを表します。
オブジェクト URL を解放するには、revokeObjectURL() を呼び出してください。
メモ:この機能はメモリーリークを生み出す可能性があるため、サービスワーカー内で利用することはできません。
構文
URL.createObjectURL(object)引数
objectオブジェクト URL を生成するための
File,Blob,MediaSourceのいずれかのオブジェクトです。
返値
object で指定された内容を参照するために使用されるオブジェクト URL の入った文字列です。
例
オブジェクト URL で画像を表示を参照してください。
使用上のメモ
メモリー管理
すでにオブジェクト URL が生成されている場合でも、createObjectURL() を呼び出す度に、新しいオブジェクト URL が生成されます。 必要がなくなったらURL.revokeObjectURL_static を呼び出して、それぞれを解放してください。
ブラウザーは、文書がアンロードされた際にこれらのオブジェクト URL をメモリーから解放します。しかし、性能とメモリー使用を考慮すると、明示的にアンロードできる安全な機会があるならば、そうするべきです。
メディアストリームのオブジェクト URL の使用
古いバージョンの Media Source 仕様書では、<video> 要素にストリームを添付するにはMediaStream にオブジェクト URL を生成する必要があるとしてます。 これはもう必要なく、ブラウザーはこのようにする対応を削除してきています。
警告:もしcreateObjectURL() でメディア要素にストリームを割り当てるコードが残っているのであれば、単純にsrcObject を直接MediaStream に設定するよう更新する必要があります。
仕様書
| Specification |
|---|
| File API # dfn-createObjectURL |