FileSystemEntry: метод copyTo()

Устаревший: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её всё ещё поддерживать, она, возможно, уже удалена из соответствующих веб-стандартов, может быть в процессе удаления или сохранена только для совместимости. Избегайте её использования и обновляйте существующий код, если это возможно; обратитесь к таблице совместимости внизу этой страницы, чтобы принять решение. Имейте в виду, что эта функция может перестать работать в любое время.

Нестандартный: Эта функция не является стандартной и не находится на пути к стандартизации. Не используйте её на сайтах, ориентированных на веб, в производственной среде: она не будет работать для всех пользователей. Также могут существовать значительные несовместимости между реализациями, и поведение может измениться в будущем.

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

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

Директория не может быть скопирована в саму себя.
Запись не может быть скопирована в родительскую директорию, если вы не укажете новое имя.
При копировании директории копирование всегда рекурсивное; вы не можете исключить подпапки.

Синтаксис

copyTo(newParent)
copyTo(newParent, newName)
copyTo(newParent, newName, successCallback)
copyTo(newParent, newName, successCallback, errorCallback)

Параметры

newParent: Объект FileSystemDirectoryEntry, указывающий целевую директорию для операции копирования.
newName Необязательно: Если этот параметр указан, копия получает это строковое значение в качестве нового имени файла или директории.
successCallback Необязательно: Функция, которая вызывается, когда операция копирования успешно завершается. Принимает один входной параметр: объект, основанный на FileSystemEntry, предоставляющий новые детали скопированного элемента.
errorCallback Необязательно: Необязательный обратный вызов, который выполняется, если при копировании элементов возникает ошибка. Есть один параметр: FileError, описывающий причину ошибки.

Возвращаемое значение

None (undefined).

Исключения

FileError.INVALID_MODIFICATION_ERR: Запрошенная операция включает в себя невозможное изменение, например, перемещение директории внутрь себя или одной из своих дочерних директорий, или копирование элемента внутри той же директории без переименования.
FileError.QUOTA_EXCEEDED_ERR: Операция превысила квоту пользователя на хранение или не хватает места на хранилище для завершения операции.

Примеры

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

workingDirectory.getFile(
  "tmp/log.txt",
  {},
  (fileEntry) => {
    workingDirectory.getDirectory(
      "log",
      {},
      (dirEntry) => {
        fileEntry.copyTo(dirEntry);
      },
      handleError,
    );
  },
  handleError,
);

Совместимость с браузерами

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`copyTo`	8	79	Нет	Нет	Нет	18	Нет	14	Нет	1.0	≤37

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FileSystemEntry/copyTo