FileSystemHandle

Интерфейс FileSystemHandle API файловой системы — это объект, представляющий запись файла или каталога. Несколько обработчиков могут представлять одну и ту же запись. В основном вы работаете не с FileSystemHandle напрямую, а с его дочерними интерфейсами FileSystemFileHandle и FileSystemDirectoryHandle.

Ниже представлен список интерфейсов, основанных на интерфейсе FileSystemHandle.

FileSystemFileHandle

Представляет обработчик записи файла.

FileSystemDirectoryHandle

Предоставляет обработчик записи каталога.

kind Только для чтения

Возвращает тип записи. Это 'file' , если связанная запись — файл, или 'directory'.

name Только для чтения

Возвращает имя связанной записи.

isSameEntry()

Сравнивает два обработчика, чтобы определить, совпадают ли связанные записи (файл или каталог).

queryPermission() Экспериментальная

Запрашивает текущее состояние разрешения для текущего обработчика.

remove() Экспериментальная Нестандартная

Запрашивает удаление записи, представленной обработчиком, из базовой файловой системы.

requestPermission() Экспериментальная

Запрашивает разрешение на чтение или запись для обработчика файла.

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

// store a reference to our file handle
let fileHandle;

async function getFile() {
  // open file picker
  [fileHandle] = await window.showOpenFilePicker();

  if (fileHandle.kind === "file") {
    // run file code
  } else if (fileHandle.kind === "directory") {
    // run directory code
  }
}

Следующая асинхронная функция возвращает true, если пользователь предоставил разрешение на чтение или запись для обработчика файла. Разрешение запрашивается, если оно отсутствует.

// 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;
}

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

function removeMatches(fileEntry, entriesArr) {
  const newArr = entriesArr.filter((entry) => !fileEntry.isSameEntry(entry));

  return newArr;
}

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