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, die zur Identifizierung des Dateisystemeintrags verwendet werden kann. Dies erfolgt durch die Einführung eines neuen URL-Schemas—filesystem:—das als Wert der src und href Attribute verwendet werden kann.

Syntax

js
toURL()
toURL(mimeType)

Parameter

mimeType Optional

Ein optionaler String, der den MIME-Typ angibt, der bei der Interpretation der Datei verwendet werden soll. Dies kann verwendet werden, um mit Dateien umzugehen, deren Typen nicht automatisch vom Benutzeragenten 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 (z.B. 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 ihre 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 namens awesome-sauce.jpg enthält, könnte die von toURL() zurückgegebene URL (abhängig von der Implementierung des Browsers) ungefähr so aussehen: "filesystem:http://my-awesome-website.woot/temporary/awesome-sauce.jpg".

Code, der dies nutzt, könnte folgendermaßen aussehen:

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

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

Angenommen, das zuvor erwähnte Szenario vor dem Code wird umgesetzt, würde das Ergebnis HTML wie dieses sein, das an das Ende des Dokuments angehängt wird:

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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
toURL
DeprecatedNon-standard

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.

Siehe auch