FileSystemEntry: toURL() 方法

已弃用: 此功能不再推荐使用。虽然一些浏览器可能仍然支持它,但它可能已被从相关的 Web 标准中删除,可能正在被删除,或者可能仅保留为了兼容性目的。避免使用它,如果可能,更新现有的代码;请参阅此页面底部的 兼容性表 来指导您的决定。请注意,此功能可能在任何时候停止工作。

非标准: 此功能是非标准的,不在标准化轨道上。不要在面向 Web 的生产网站上使用它:它不会为所有用户工作。实现之间也可能存在很大的不兼容性,并且行为在将来可能会发生变化。

FileSystemEntry 接口的方法 toURL() 创建并返回一个包含 URL 的字符串,该 URL 可用于标识文件系统条目。这是通过公开一个新的 URL 方案 — filesystem: — 来实现的,该方案可用作 srchref 属性的值。

语法

js
toURL()
toURL(mimeType)

参数

mimeType 可选

一个可选字符串,指定在解释文件时要使用的 MIME 类型。这可用于帮助处理用户代理无法自动识别的文件类型。如果省略此参数,用户代理将使用其标准算法识别文件。

返回值

包含一个 URL 的字符串,该 URL 随后可用作 HTML 内容中的文档引用,或者如果 URL 无法生成(例如,如果文件系统实现不支持 toURL()),则为一个空字符串。

示例

如果您有一个对应于您的网站或应用程序可用的文件系统中的图像文件的 FileSystemFileEntry,您可以调用 toURL() 来获取其 URL 以在 HTML 中使用。如果您的网站位于 http://my-awesome-website.woot,并且您有一个包含名为 awesomesauce.jpg 的图像文件的临时文件系统,则 toURL() 返回的 URL 可能是(取决于浏览器的实现)类似于 "filesystem:http://my-awesome-website.woot/temporary/awesomesauce.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/awesomesauce.jpg" />

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅