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

BCD tables only load in the browser

Mirar también