FileSystemEntry: toURL() Methode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Nicht standardisiert: Diese Funktion ist nicht standardisiert und befindet sich nicht auf dem Weg zur Standardisierung. Verwenden Sie sie nicht auf Produktionsseiten, die dem Web ausgesetzt sind: Sie funktioniert nicht für alle Benutzer. Es kann auch 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