class File/Downloader

File/Downloader применяется для скачивания файлов в кодировке Base64 и документов, доступных по URL.

В качестве опций получает: - entity - сущность для скачивания, закодированная в base64 строка, либо URL адрес документа - fileParams (опционально) - объект параметров загружаемого файла (только для base64). - fileDriver (опционально) - файловый драйвер, передается, чтобы явно указать тип загружаемого файла.

Если файловый драйвер не передан, File/Downloader пытается сам определить файл, и выбрать соответствующий способ скачивания.

Имена файловых драйверов доступны в Downloader.DRIVERS_NAMES

- (опционально) saveMethod - Метод сохранения файла, указывается, чтобы явно указать способ сохранения файла (см. Downloader.SAVE_METHODS )

Возможные варианты: - Downloader.SAVE_METHODS.IFRAME - сохранение через невидимый iframe, быстро, но не позволяет задать параметры сохраняемого файла. - Downloader.SAVE_METHODS.BLOB - сохранение через конвертацию в Blob, медленее iframe, но позволяет задать параметры сохраняемого файла.

Возвращаемое значение: - В случае скачивания Base64 строки возвращает `Promise<void | Error>` - В случае скачивания URL адреса возвращает `Promise<Response| void | Error>`

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

Примеры

require(['File/Downloader'], function(Downloader) {

    // Скачивание base64 файла
    var base64_text = "wqtXZWVrcyBvZiBjb2RpbmcgY2FuIHNhdmUgeW91IGhvdXJzIG9mIHBsYW5uaW5nwrssDQogdW5rbm93biBhcnRpc3Qu";

    Downloader(base64_text, {
         name: 'phrase.txt',              // Имя, под которым файл будет сохранен (опционально)
         contentType: 'text/plain'        // Тип контента (опционально)
     }, Downloader.DRIVERS_NAMES.Base64)  // Имя файлового драйвера, указывает тип скачиваемого файла (опционально)
    .catch(console.error);                // Обработчик ошибки скачивания


    // Скачивание документа по URL
    Downloader("https://bad_url").then(parseResponse).catch(console.error);
 });

Опции

URL документа, либо файл в кодировке Base64

Имя файлового драйвера, явно указывает тип скачиваемого файла

Параметры скачиваемого файла

Метод сохранения файла, указывается,

чтобы явно указать способ сохранения файла (см. Downloader.SAVE_METHODS )

Тайпдефы