URL: createObjectURL() statische Methode

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.

Hinweis: Diese Funktion ist in Web Workers verfügbar, mit Ausnahme von Service Workers.

Die createObjectURL() statische Methode der URL-Schnittstelle erstellt eine Zeichenkette, die eine URL enthält, die das im Parameter angegebene Objekt darstellt.

Die Lebensdauer der URL ist an das document im Fenster gebunden, in dem sie erstellt wurde. Die neue Objekt-URL repräsentiert das angegebene File- oder Blob-Objekt.

Um eine Objekt-URL freizugeben, rufen Sie revokeObjectURL() auf.

Hinweis: Diese Funktion ist in Service Workers nicht verfügbar, da sie potenzielle Speicherlecks verursachen könnte.

Syntax

URL.createObjectURL(object)

Parameter

object: Ein File-, Blob- oder MediaSource-Objekt, für das eine Objekt-URL erstellt werden soll.

Rückgabewert

Eine Zeichenkette, die eine Objekt-URL enthält, die zum Referenzieren der Inhalte des angegebenen Quell-object verwendet werden kann.

Beispiele

Siehe Verwendung von Objekt-URLs zur Anzeige von Bildern.

Jedes Mal, wenn Sie createObjectURL() aufrufen, wird eine neue Objekt-URL erstellt, selbst wenn Sie bereits eine für dasselbe Objekt erstellt haben. Jede dieser URLs muss freigegeben werden, indem URL.revokeObjectURL() aufgerufen wird, wenn Sie sie nicht mehr benötigen.

Browser geben Objekt-URLs automatisch frei, wenn das Dokument entladen wird; allerdings sollten Sie aus Gründen der optimalen Leistung und Speichernutzung die URLs explizit freigeben, wenn es sichere Zeitpunkte gibt.

Verwendung von Objekt-URLs für Medienströme

In älteren Versionen der Media Source-Spezifikation erforderte das Anhängen eines Streams an ein <video>-Element die Erstellung einer Objekt-URL für den MediaStream. Dies ist nicht mehr notwendig, und die Browser entfernen die Unterstützung dafür.

Warnung: Falls Ihr Code noch darauf angewiesen ist, createObjectURL() zu verwenden, um Streams an Medienelemente anzuhängen, müssen Sie Ihren Code aktualisieren, um srcObject direkt auf den MediaStream zu setzen.

Spezifikationen

Specification
File API # dfn-createObjectURL

Browser-Kompatibilität

BCD tables only load in the browser