Метод Window: showSaveFilePicker()

Метод showSaveFilePicker() интерфейса Window отображает выборщик файлов, который позволяет пользователю сохранить файл. Выбирая существующий файл или введя имя для нового файла.

options Необязательно

Объект, содержащий опции:

excludeAcceptAllOption Необязательно

Логическое значение, по умолчанию false. По умолчанию выборщик должен включать опцию для отключения фильтрации типов файлов (инициируемой опцией type ниже). Установка этого параметра в true означает, что эта опция не доступна.

id Необязательно

Указание идентификатора позволяет браузеру запоминать разные каталоги для разных идентификаторов. Если для другого выборщика используется тот же идентификатор, выборщик открывается в том же каталоге.

startIn Необязательно

FileSystemHandle или известный каталог ("desktop", "documents", "downloads", "music", "pictures", или "videos"), для открытия диалога.

suggestedName Необязательно

Значение String. Предлагаемое имя файла.

types Необязательно

Массив Array разрешённых типов файлов для сохранения. Каждый элемент — объект со следующими опциями:

description Необязательно

Необязательное описание категории разрешённых типов файлов. По умолчанию пустая строка.

accept

Объект Object с ключами, установленными на тип MIME, и значениями, являющимися массивом Array расширений файлов (пример ниже).

Обещание Promise, обработчик выполнения которого получает объект FileSystemFileHandle.

AbortError DOMException

Выбрасывается, если пользователь закрывает выборщик файлов, не выбрав или не введя файл, или если пользовательский агент считает выбранные файлы слишком конфиденциальными или опасными.

SecurityError DOMException

Выбрасывается, если вызов заблокирован политикой одного происхождения или он не был вызван с помощью пользовательского взаимодействия, такого как нажатие кнопки.

TypeError

Выбрасывается, если типы accept не могут быть обработаны, что может произойти, если:

• Любой строковый ключ опций accept любого элемента в опциях types не может обработать допустимый тип MIME.
• Любая строковая(ые) значения опций accept любого элемента в опциях types недопустимы, например, если они не начинаются с . и заканчиваются ., или если они содержат недопустимые кодовые точки и их длина превышает 16.
• Опции types пустые, а опции excludeAcceptAllOption true.

Требуется временное подтверждение пользователя. Пользователь должен взаимодействовать со страницей или элементом пользовательского интерфейса для работы этой функции.

Следующая функция показывает выборщик файлов, с выделением текстовых файлов для выбора.

async function getNewFileHandle() {
  const opts = {
    types: [
      {
        description: "Text file",
        accept: { "text/plain": [".txt"] },
      },
    ],
  };
  return await window.showSaveFilePicker(opts);
}

• API файловой системы
• API доступа к файловой системе: упрощение доступа к локальным файлам