Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade 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 julho de 2015.
O método estáticoURL.createObjectURL() cria umDOMString contendo a URL representando o objeto passado como parâmetro.
O tempo de vida da URL é vinculado aodocument da janela onde ele foi criado. O novo objeto URL represenda o objetoFile especificado ou o objetoBlob.
Para anular um objeto URL, execute o métodorevokeObjectURL()
Nota: This feature is available inWeb Workers.
Nota:Esta funcionalidade não está disponível emService Workers devido ao potencial de criar vazamento de memória
Sintaxe
const objectURL = URL.createObjectURL(object);Parâmetros
objectUm
File,Blob, ou objetoMediaSourcepara criar um objeto URL.
Retorno de valor
UmaDOMString contendo o objeto URL e pode ser usado para referenciar o conteúdo especificado na origem doobject.
Exemplos
Notas de uso
Gerenciamento de memória
Cada vez que você executacreateObjectURL(), um novo objeto URL é criado, mesmo que você já tenha criado este objeto. Cada um desses pode ser eliminado executando o métodoURL.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 oMediaStream. Isto não é mais necessário, e os navegadores estão removendo o suporte para isso.
Aviso:Se você ainda tem código comcreateObjectURL() para anexar streams em elementosde media, você precisa atualizar seu código parasrcObject to theMediaStream directly.
Especificações
| Specification |
|---|
| File API # dfn-createObjectURL |