Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
URL.createObjectURL
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode statiqueURL.createObjectURL() crée une chaîne contenant une URL représentant l'objet passé en paramètre. La durée de vie de l'URL est liée audocument de la fenêtre depuis laquelle elle a été créée. La nouvelle URL d'objet représente l'objetFile ouBlob spécifié.
Pour libérer une URL d'objet, il faut appelerrevokeObjectURL()
Note : Cette fonctionnalité est disponible via lesWeb Workers.
Note :Cette fonctionnalité n'est pas disponible dans lesService Workers à cause de possible fuite mémoire.
Syntaxe
objectURL = URL.createObjectURL(object);Paramètres
objectUn objet
File,BlobouMediaSourcepour lequel créer une URL d'objet.
Valeur de retour
UneDOMString contenant une URL d'objet, pouvant être utilisée comme une référence vers l'objet sourceobject spécifié.
Exemple
Notes d'utilisation
Gestion de la mémoire
À chaque fois que vous appelezcreateObjectURL(), une nouvelle URL d'objet est créée, même si vous en avez déjà créée une pour le même objet. Chacune d'elles doit être libérée en appelantURL.revokeObjectURL() lorsque vous n'en avez plus besoin.
Les navigateurs libèrent automatiquement les URL d'objet lorsque le document est déchargé (unload) ; cependant, pour une performance et une utilisation de la mémoire optimales, si vous avez la possiblité de les libérer explictement sans danger, vous devriez le faire.
Utiliser les URL d'objet pour les flux de média
Dans d'anciennes versions de la spécification de Media Source, attacher un flux à un élément<video> requérait de créer une URL d'objet pour leMediaStream. Cela n'est plus nécessaire, et les navigateurs cessent progressivement de supporter cette pratique.
Attention :Si vous avez toujours du code qui repose surURL.createObjectURL pour attacher des flux à des éléments média, vous devez mettre à jour votre code pour attacher simplementsrcObject directement auMediaStream.
Spécifications
| Specification |
|---|
| File API # dfn-createObjectURL |