URL.createObjectURL

Baseline Large disponibilit

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.

En savoir plus
Voir la compatibilit complte

La mthode statique URL.createObjectURL() cre une chane contenant une URL reprsentant l'objet pass en paramtre. La dure de vie de l'URL est lie au document de la fentre depuis laquelle elle a t cre. La nouvelle URL d'objet reprsente l'objet File ou Blob spcifi.

Pour librer une URL d'objet, il faut appeler revokeObjectURL()

Note : Cette fonctionnalit est disponible via les Web Workers.

Note : Cette fonctionnalit n'est pas disponible dans les Service Workers cause de possible fuite mmoire.

Syntaxe

objectURL = URL.createObjectURL(object);

Paramtres

object: Un objet File, Blob ou MediaSource pour lequel crer une URL d'objet.

Valeur de retour

Une String contenant une URL d'objet, pouvant tre utilise comme une rfrence vers l'objet source object spcifi.

Exemple

Voir Utilisation de l'objet URLs pour afficher des images.

Notes d'utilisation

Gestion de la mmoire

chaque fois que vous appelez createObjectURL(), une nouvelle URL d'objet est cre, mme si vous en avez dj cre une pour le mme objet. Chacune d'elles doit tre libre en appelant URL.revokeObjectURL() lorsque vous n'en avez plus besoin.

Les navigateurs librent automatiquement les URL d'objet lorsque le document est dcharg (unload) ; cependant, pour une performance et une utilisation de la mmoire optimales, si vous avez la possiblit de les librer explictement sans danger, vous devriez le faire.

Utiliser les URL d'objet pour les flux de mdia

Dans d'anciennes versions de la spcification de Media Source, attacher un flux un lment <video> requrait de crer une URL d'objet pour le MediaStream. Cela n'est plus ncessaire, et les navigateurs cessent progressivement de supporter cette pratique.

Attention : Si vous avez toujours du code qui repose sur URL.createObjectURL pour attacher des flux des lments mdia, vous devez mettre jour votre code pour attacher simplement srcObject directement au MediaStream.

Spcifications

Spcification
File API # dfn-createObjectURL

Compatibilit des navigateurs

Voir aussi

Aider amliorer MDN

Cette page vous a-t-elle t utile ?

Oui Non

Apprendre contribuer

Cette page a t modifie le 22 mai 2026 par les contributeurices du MDN.

Voir cette page sur GitHub Signaler un problme avec ce contenu

URL
Constructeur
1. URL()
Proprits d'instance
Mthodes statiques
Mthodes d'instance
1. toJSON()
2. toString()