Summary

Creates a new object URL, whose lifetime is tied to the document in the window on which it was created. The new object URL represents the specified File object.

Syntax

objectURL = window.URL.createObjectURL(file);

• file is a File object indicating the file to create a object URL for.
• objectURL is the generated object URL. The entire contents of the specified file are represented by the text of the URL.

Example

See Using object URLs to display images.

Notes

Each time you call createObjectURL(), a new object URL is created, even if you've already created one for the same file. Each of these must be released by calling window.URL.revokeObjectURL() when you no longer need them. Browsers will release these automatically when the document is unloaded; however, for optimal performance and memory usage, if there are safe times when you can explicitly unload them, you should do so.

Browser compatibility

See also

• window.URL.revokeObjectURL()
• Using files from web applications
• File API specification