FileSystemHandle: метод requestPermission()

Метод requestPermission() интерфейса FileSystemHandle запрашивает разрешения на чтение или чтение/запись для обработчика файла.

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

Объект, который определяет режим разрешения, который нужно запросить. Доступные варианты:

'mode' Необязательно

Может быть либо 'read' или 'readwrite'.

Объект Promise, который разрешается с PermissionStatus.state, которое может быть одним из значений 'granted', 'denied' или 'prompt'. Он также может быть отклонен одним из исключений ниже.

TypeError

Выбрасывается, если не указан параметр или mode не соответствует 'read' или 'readwrite'

SecurityError DOMException

Выбрасывается в следующих случаях:

• Метод был вызван в контексте, который не является одним и тем же сайтом, что и верхний уровень контекста (например, в iframe другого сайта).
• Не было транзиентной активации пользователя, такой как нажатие кнопки. Это включает случаи, когда обработчик находится в контексте, отличном от окна, например, в работнике.

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

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

// fileHandle is a FileSystemFileHandle
// withWrite is a boolean set to true if write

async function verifyPermission(fileHandle, withWrite) {
  const opts = {};
  if (withWrite) {
    opts.mode = "readwrite";
  }

  // Check if we already have permission, if so, return true.
  if ((await fileHandle.queryPermission(opts)) === "granted") {
    return true;
  }

  // Request permission to the file, if the user grants permission, return true.
  if ((await fileHandle.requestPermission(opts)) === "granted") {
    return true;
  }

  // The user did not grant permission, return false.
  return false;
}

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