URL: метод createObjectURL() статический

Базовая поддержка Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с января 2020 года.

Примечание: Эта функция доступна в Потоках Web Workers, но не в Рабочих потоках Service Workers.

Статический метод createObjectURL() интерфейса URL создаёт строку, содержащую URL, представляющий объект, переданный в качестве параметра.

Срок действия URL связан с document в окне, в котором он был создан. Новый URL объекта представляет указанный объект File или объект Blob.

Чтобы освободить URL объекта, вызовите revokeObjectURL().

Примечание: Эта функция не доступна в Рабочих потоках Service Workers из-за потенциальных проблем с утечкой памяти.

Синтаксис

URL.createObjectURL(object)

Параметры

object: Объект File, Blob или MediaSource для создания URL объекта.

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

Строка, содержащая URL объекта, который можно использовать для ссылки на содержимое указанного источника object.

Примеры

См. Использование URL объектов для отображения изображений.

Примечания по использованию

Управление памятью

Каждый раз, когда вы вызываете createObjectURL(), создаётся новый URL объекта, даже если вы уже создали его для того же объекта. Каждый из них должен быть освобождён вызовом URL.revokeObjectURL(), когда вы больше не нуждаетесь в нём.

Браузеры автоматически освободят URL объектов при выгрузке документа; однако для оптимальной производительности и использования памяти, если есть безопасные моменты для явной выгрузки, вы должны сделать это.

Использование URL объектов для потоков медиа

В более ранних версиях спецификации Media Source для подключения потока к элементу <video> требовалось создание URL объекта для MediaStream. Это больше не нужно, и браузеры удаляют поддержку этой операции.

Предупреждение: Если у вас всё ещё есть код, который полагается на createObjectURL() для подключения потоков к медиа-элементам, вам нужно обновить код, чтобы установить srcObject в MediaStream непосредственно.

Спецификации

Спецификация
File API # dfn-createObjectURL

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`createObjectURL_static`	19	12	19 `createObjectURL()` больше недоступен в контексте `ServiceWorker`.	15	6	25	19 `createObjectURL()` больше недоступен в контексте `ServiceWorker`.	14	6	1.5	4.4

См. также

© 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/URL/createObjectURL_static