FileSystemEntry: toURL() Methode
Deprecated
Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Die Methode toURL() des FileSystemEntry Interfaces erstellt und gibt einen Zeichenfolgen-URL zurück, der verwendet werden kann, um das Dateisystem-Eintrag zu identifizieren. Dies geschieht, indem ein neues URL-Schema—filesystem:—eingeführt wird, das als Wert der Attribute src und href verwendet werden kann.
Syntax
toURL()
toURL(mimeType)
Parameter
mimeTypeOptional-
Ein optionaler String, der den MIME-Typ angibt, der beim Interpretieren der Datei verwendet werden soll. Dies kann dazu verwendet werden, 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 Dokumentreferenz in HTML-Inhalten verwendet werden kann, oder ein leerer String, wenn die URL nicht generiert werden kann (zum Beispiel, wenn die Dateisystemimplementierung toURL() nicht unterstützt).
Beispiele
Wenn Sie ein FileSystemFileEntry haben, das einer Bilddatei in einem Dateisystem entspricht, das Ihrer Website oder App zur Verfügung steht, können Sie toURL() aufrufen, um seine URL für die Verwendung in HTML zu erhalten. Wenn sich Ihre Seite unter http://my-awesome-website.woot befindet und Sie ein temporäres Dateisystem haben, das eine Bilddatei mit dem Namen awesome-sauce.jpg enthält, könnte die von toURL() zurückgegebene URL (je nach Implementierung des Browsers) so aussehen: "filesystem:http://my-awesome-website.woot/temporary/awesome-sauce.jpg".
Code, der dies verwendet, könnte so aussehen:
const img = document.createElement("img");
img.src = imageFileEntry.toURL();
img.alt = "";
document.body.appendChild(img);
Angenommen, das vor dem Code erwähnte Szenario würde das Resultat HTML sein, das folgendermaßen aussieht und am Ende des Dokuments angehängt wird:
<img
src="filesystem:http://my-awesome-website.woot/temporary/awesome-sauce.jpg"
alt="" />