FileSystemEntry: toURL() Methode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Kein Standard: Diese Funktion ist nicht standardisiert und befindet sich nicht im Standardisierungsprozess. Verwenden Sie sie nicht auf Produktionsseiten, die auf das Web ausgerichtet sind: Sie wird nicht für alle Benutzer funktionieren. Außerdem kann es große Inkompatibilitäten zwischen Implementierungen geben und das Verhalten kann sich in Zukunft ändern.

Die Methode toURL() des FileSystemEntry Interfaces erstellt und gibt einen String zurück, der eine URL enthält, mit der der Dateisystemeintrag identifiziert werden kann. Dies geschieht durch das Bereitstellen eines neuen URL-Schemas—filesystem:—das als Wert für die Attribute src und href verwendet werden kann.

Syntax

js
toURL()
toURL(mimeType)

Parameter

mimeType Optional

Ein optionaler String, der den MIME-Typ angibt, der beim Interpretieren der Datei verwendet werden soll. Dies kann hilfreich sein, um mit Dateien umzugehen, deren Typen vom Benutzeragenten nicht automatisch erkannt werden. Wenn dieser Parameter weggelassen wird, verwendet der Benutzeragent seine Standardalgorithmen, um die Datei zu identifizieren.

Rückgabewert

Ein String, der eine URL enthält, die dann als Dokumentenreferenz in HTML-Inhalten verwendet werden kann, oder ein leerer String, wenn die URL nicht generiert werden kann (z. B. wenn die Dateisystemimplementierung toURL() nicht unterstützt).

Beispiele

Wenn Sie einen FileSystemFileEntry besitzen, der einer Bilddatei in einem für Ihre Website oder App verfügbaren Dateisystem entspricht, können Sie toURL() aufrufen, um dessen URL für die Verwendung in HTML zu erhalten. Wenn sich Ihre Website unter http://my-awesome-website.woot befindet und Sie ein temporäres Dateisystem haben, das eine Bilddatei namens awesome-sauce.jpg enthält, könnte die von toURL() zurückgegebene URL (abhängig von der Implementierung des Browsers) in etwa so aussehen: "filesystem:http://my-awesome-website.woot/temporary/awesome-sauce.jpg".

Code, der dies verwendet, könnte so aussehen:

js
let img = document.createElement("img");

img.src = imageFileEntry.toURL();
document.body.appendChild(img);

Unter der Annahme des vor dem Code genannten Szenarios würde das Ergebnis HTML sein, das so aussieht, als würde es am Ende des Dokuments angehängt:

html
<img
  src="filesystem:http://my-awesome-website.woot/temporary/awesome-sauce.jpg" />

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch