FileSystemEntry: метод toURL()

Устарело: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её всё ещё поддерживать, она может быть удалена из соответствующих веб-стандартов, находится в процессе удаления или поддерживается только для совместимости. Избегайте её использования и, если возможно, обновите существующий код; см. таблицу совместимости внизу этой страницы, чтобы принять решение. Имейте в виду, что эта функция может перестать работать в любое время.

Нестандартно: Эта функция не является стандартной и не находится на пути стандартизации. Не используйте её на производственных сайтах, работающих в сети: она не будет работать для каждого пользователя. Также могут быть большие несовместимости между реализациями, и поведение может измениться в будущем.

Метод интерфейса FileSystemEntry toURL() создаёт и возвращает строку, содержащую URL, который можно использовать для идентификации записи файловой системы. Это делается путём экспонирования новой схемы URL — filesystem: — которая может быть использована в качестве значения атрибутов src и href.

Синтаксис

toURL()
toURL(mimeType)

Параметры

mimeType Необязательно: Необязательная строка, определяющая MIME-тип для интерпретации файла. Это может быть использовано для работы с файлами, типы которых не распознаются автоматически пользовательским агентом. Если этот параметр опущен, пользовательский агент использует свои стандартные алгоритмы для определения типа файла.

Возвращаемое значение

Строка, содержащая URL, который затем можно использовать в качестве ссылки на документ в HTML-содержимом, или пустая строка, если URL не может быть сгенерирован (например, если реализация файловой системы не поддерживает toURL()).

Примеры

Если у вас есть FileSystemFileEntry, соответствующий изображению в файловой системе, доступной вашему веб-сайту или приложению, вы можете вызвать toURL() для получения его URL для использования в HTML. Если ваш сайт расположен по адресу http://my-awesome-website.woot, и у вас есть временная файловая система, содержащая изображение с именем awesome-sauce.jpg, возвращаемый URL toURL() может быть (в зависимости от реализации браузера) чем-то вроде "filesystem:http://my-awesome-website.woot/temporary/awesome-sauce.jpg".

Код, использующий эту функцию, может выглядеть так:

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

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

Предполагая сценарий, упомянутый перед кодом, результатом будет HTML, который будет добавлен в конец документа:

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

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`toURL`	8	79	Нет	Нет	Нет	18	Нет	14	Нет	1.0	≤37

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FileSystemEntry/toURL