FileSystemEntry: метод getParent()

Метод интерфейса FileSystemEntry getParent() получает FileSystemDirectoryEntry.

successCallback

Функция, вызываемая при получении записи родительского каталога. Обратный вызов принимает один входной параметр: объект FileSystemDirectoryEntry, представляющий родительский каталог. Родитель корневого каталога — это сам корневой каталог, поэтому обратите на это внимание.

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

Необязательный обратный вызов, выполняемый при возникновении ошибки. Он принимает один параметр: объект DOMException, описывающий причину ошибки.

None (undefined).

FileError.INVALID_STATE_ERR

Операция не удалась, потому что состояние файловой системы не позволяет её выполнить. Это может произойти, например, если кэшированное состояние файловой системы отличается от фактического состояния.

FileError.NOT_FOUND_ERR

Указанный путь не был найден.

FileError.SECURITY_ERR

Ограничения безопасности запрещают получение информации о родительском каталоге.

В этом примере переименовывается файл, указанный переменной fileEntry в "newname.html".

fileEntry.getParent(
  (parent) => {
    fileEntry.moveTo(parent, "newname.html", (updatedEntry) => {
      console.log(`File ${fileEntry.name} renamed to newname.html.`);
    });
  },
  (error) => {
    console.error(
      `An error occurred: Unable to rename ${fileEntry.name} to newname.html.`,
    );
  },
);

Это достигается путём получения объекта FileSystemDirectoryEntry, представляющего каталог, в котором находится файл. Затем используется метод moveTo() для переименования файла в этом каталоге.

В настоящее время нет версии этого метода, основанной на Promise. Однако вы можете создать простую вспомогательную функцию для его адаптации, как показано ниже:

function getParentPromise(entry) {
  return new Promise((resolve, reject) => {
    entry.getParent(resolve, reject);
  });
}

Аналогичный подход можно использовать и в других частях API файлов и каталогов.

• API файлов и каталогов
• Введение в API файлов и каталогов