URL.createObjectURL()


O método estático URL.createObjectURL() cria um DOMString contendo a URL representando o objeto passado como parâmetro.

O tempo de vida da URL é vinculado ao document da janela onde ele foi criado. O novo objeto URL represenda o objeto File especificado ou o objeto Blob.

Para anular um objeto URL, execute o método revokeObjectURL()

Note: This feature is available in Web Workers

Nota: Esta funcionalidade não está disponível em Service Workers devido ao potencial de criar vazamento de memória

Sintaxe

js
const objectURL = URL.createObjectURL(object);

Parâmetros

object

Um File, Blob, ou objeto MediaSource (en-US) para criar um objeto URL.

Retorno de valor

Uma DOMString contendo o objeto URL e pode ser usado para referenciar o conteúdo especificado na origem do object.

Exemplos

Notas de uso

Gerenciamento de memória

Cada vez que você executa createObjectURL(), um novo objeto URL é criado, mesmo que você já tenha criado este objeto. Cada um desses pode ser eliminado executando o método URL.revokeObjectURL() quando você não precisa mais dele.

Os navegadores vão limpar objetos URLs automaticamente quando o documento for descarregado; contudo, para otimizar a performace e o uso de memória, se há momentos que é seguro descarregar, você deve fazer isso.

Usando objeto URL para media stream

Em versões antigas da especificação Media Source, anexar stream a um elemento <video> é obrigatório criar um objeto URL para o MediaStream (en-US). Isto não é mais necessário, e os navegadores estão removendo o suporte para isso.

Warning: Se você ainda tem código com createObjectURL() para anexar streams em elementos de media, você precisa atualizar seu código para srcObject (en-US) to the MediaStream directly.

Especificações

Specification
File API
# dfn-createObjectURL

Compatibilidade de browser

BCD tables only load in the browser

Veja também