FileSystemEntry: метод moveTo()

Метод moveTo() интерфейса FileSystemEntry перемещает файл, указанный записью, в новое местоположение в файловой системе или переименовывает файл, если целевой каталог такой же, как исходный.

Существуют некоторые типичные ограничения на то, что вы можете сделать:

• Каталог не может быть перемещён в самого себя.
• Запись не может быть перемещена в родительский каталог, если не указано новое имя. Указание нового имени позволяет moveTo() выполнять операцию переименования.
• При перемещении каталога перемещение всегда рекурсивное; вы не можете пропустить подкаталоги.
• Вы не можете переместить файл так, чтобы он заменил существующий каталог, и вы не можете переместить каталог так, чтобы он заменил существующий файл. Однако файл может заменить файл, а каталог может заменить каталог.
• Вы можете перезаписать каталог только если он пустой.

newParent

Объект FileSystemDirectoryEntry, указывающий целевой каталог для операции перемещения.

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

Если этот параметр предоставлен, запись переименовывается в строку с новым именем файла или каталога.

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

Функция, которая вызывается, когда операция перемещения выполняется успешно. Принимает один входной параметр: объект на основе FileSystemEntry, предоставляющий новые данные перемещённого элемента.

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

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

None (undefined).

FileError.INVALID_MODIFICATION_ERR

Запрашиваемая операция включает в себя невозможное изменение, например, перемещение каталога в себя или один из своих дочерних каталогов, или копирование элемента в том же каталоге без переименования.

FileError.QUOTA_EXCEEDED_ERR

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

Этот пример демонстрирует, как временный файл журнала может быть перемещён в более постоянный каталог "log", когда его размер превышает один мегабайт.

workingDirectory.getFile(
  "tmp/log.txt",
  {},
  (fileEntry) => {
    fileEntry.getMetadata((metadata) => {
      if (metadata.size > 1048576) {
        workingDirectory.getDirectory(
          "log",
          {},
          (dirEntry) => {
            fileEntry.moveTo(dirEntry);
          },
          handleError,
        );
      }
    });
  },
  handleError,
);

• API для файлов и каталогов
• Введение в API для файлов и каталогов
• FileSystemEntry.copyTo()