FileSystemEntry: toURL() 方法

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

非標準:此特性未標準化。我們不建議在生產環境中使用非標準特性,因為它們瀏覽器支援有限,並且可能會更改或被移除。但是,在沒有標準選項的特定情況下,它們可以是合適的替代方案。

FileSystemEntry 介面的 toURL() 方法建立一個並返回一個字串,其中包含一個可用於標識檔案系統條目的 URL。這是透過公開一個新的 URL 方案 — filesystem: — 來實現的,該方案可用作 srchref 屬性的值。

語法

js
toURL()
toURL(mimeType)

引數

mimeType 可選

一個可選的字串,用於指定解釋檔案時要使用的 MIME 型別。這可以幫助處理使用者代理無法自動識別其型別的 [檔案]。如果省略此引數,使用者代理將使用其標準演算法來識別檔案。

返回值

一個包含 URL 的字串,該 URL 可以用作 HTML 內容中的文件引用,如果無法生成 URL(例如,如果檔案系統實現不支援 toURL()),則返回一個空字串。

示例

如果您有一個 FileSystemFileEntry,對應於網站或應用程式可用的檔案系統中的圖片檔案,您可以呼叫 toURL() 來獲取其 URL 以在 HTML 中使用。如果您的網站位於 http://my-awesome-website.woot,並且您有一個包含名為 awesome-sauce.jpg 的圖片檔案的臨時檔案系統,那麼 toURL() 返回的 URL 可能是(取決於瀏覽器的實現)類似 "filesystem:http://my-awesome-website.woot/temporary/awesome-sauce.jpg"

使用此功能的程式碼可能如下所示:

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

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

假設程式碼之前的場景,結果將是類似於以下內容的 HTML 被追加到文件的末尾。

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

瀏覽器相容性

另見