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 January 2020.

Experimental: Esta es una tecnología experimental
Comprueba la Tabla de compabilidad de navegadores cuidadosamente antes de usarla en producción.

El método estático URL.createObjectURL() crea un DOMString que contiene una URL que representa al objeto pasado como parámetro. La vida de la URL está ligado al document de la ventana en la que fue creada. El nuevo objeto URL representa al objeto File especificado o al objeto Blob.

Nota: El uso de un objeto MediaStream como entrada a este método está en proceso de ser obsoleto. Las discusiones están en curso sobre si o no debe ser quitado totalmente. Como tal, se debe de evitar usar este método con MediaStreams, y se debería usar HTMLMediaElement.srcObject().

Nota: Esta característica está disponible en Web Workers.

Sintaxis

objectURL = URL.createObjectURL(object);

Parámetros

object

Un objeto File o un objeto Blob para el que se creará la URL.

Ejemplo

Notas

Cada vez que se llama a createObjectURL(), un nuevo objeto URL es creado, incluso si ya creaste uno para el mismo objeto. Cada uno de estos objetos puede ser liberado usando URL.revokeObjectURL() cuándo ya no lo necesitas. Los navegadores liberan estos objetos cuando el documento es cerrado; de todas formas, para obtener un rendimiento óptimo y un óptimo uso de memoria, si hay momentos seguros en los que puedes liberar estos objetos deberías hacerlo. Por ejemplo: No liberar los recursos cuando se ha creado una URL a partir de un MediaStream puede dejar la luz de la cámara del navegador encendida más tiempo del necesario.

Nota: Notese que no es necesario crear URLs a partir de un MediaStream, ya que los objetos de streams deberían asignarse directamente a elementos de reproducción con HTMLMediaElement.srcObject. La posibilidad de usar un MediaStream como valor de un objeto está obsoleta.

Especificaciones

Specification
File API
# dfn-createObjectURL

Compatibilidad con navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
createObjectURL() static method

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

Mirar también