downloads.open()

Функция open() API downloads открывает загруженный файл с помощью соответствующего приложения. Событие downloads.onChanged сработает, когда элемент будет открыт в первый раз.

Чтобы использовать эту функцию в вашем расширении, необходимо запросить разрешение «downloads.open» разрешение manifest, а также разрешение «downloads». Кроме того, вы можете вызвать эту функцию только внутри обработчика действия пользователя.

Это асинхронная функция, которая возвращает Promise.

Синтаксис

let opening = browser.downloads.open(
  downloadId      // integer
)

Параметры

downloadId: Значение integer представляющее id downloads.DownloadItem, который вы хотите открыть.

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

A Promise. Если запрос был успешным, промис будет выполнен без аргументов. Если запрос завершился ошибкой, промис будет отклонен с сообщением об ошибке.

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

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet
`open`	Да	79	48	?	Да	Нет	?	?	48–79	?	Нет	?

Примеры

В этом примере открывается последний загруженный элемент:

function onOpened() {
  console.log(`Opened download item`);
}

function onError(error) {
  console.log(`Error opening item: ${error}`);
}

function openDownload(downloadItems) {
    if (downloadItems.length > 0) {
      let opening = browser.downloads.open(downloadItems[0].id);
      opening.then(onOpened, onError);
    }
  }

let searching = browser.downloads.search({
  limit: 1,
  orderBy: ["-startTime"]
});

searching.then(openDownload, onError);

Примеры расширений

latest-download

Примечание: Этот API основан на API chrome.downloads Chromium.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/downloads/open