FileSystemEntry: copyTo() Methode
Deprecated
Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Die Methode copyTo() der FileSystemEntry Schnittstelle kopiert die durch den Eintrag spezifizierte Datei an einen neuen Ort im Dateisystem.
Es gibt einige typische Einschränkungen, was Sie tun können:
- Ein Verzeichnis kann nicht in sich selbst kopiert werden.
- Ein Eintrag kann nicht in sein übergeordnetes Verzeichnis kopiert werden, es sei denn, Sie geben einen neuen Namen an.
- Beim Kopieren eines Verzeichnisses ist das Kopieren immer rekursiv; Unterordner können nicht ausgelassen werden.
Syntax
copyTo(newParent)
copyTo(newParent, newName)
copyTo(newParent, newName, successCallback)
copyTo(newParent, newName, successCallback, errorCallback)
Parameter
newParent-
Ein
FileSystemDirectoryEntry-Objekt, das das Zielverzeichnis für den Kopiervorgang angibt. newNameOptional-
Wenn dieser Parameter angegeben wird, erhält die Kopie diesen String als neuen Datei- oder Verzeichnisnamen.
successCallbackOptional-
Eine Funktion, die aufgerufen wird, wenn der Kopiervorgang erfolgreich abgeschlossen ist. Sie erhält einen einzigen Eingabeparameter: ein auf
FileSystemEntrybasierendes Objekt, das die neuen Details des kopierten Elements bereitstellt. errorCallbackOptional-
Ein optionaler Rückruf, der ausgeführt wird, wenn beim Kopieren der Elemente ein Fehler auftritt. Es gibt einen einzigen Parameter: einen
DOMException, der beschreibt, was schiefgelaufen ist.
Rückgabewert
Keiner (undefined).
Ausnahmen
DOMException.INVALID_MODIFICATION_ERR-
Der angeforderte Vorgang beinhaltet eine unmögliche Änderung, z. B. das Verschieben eines Verzeichnisses in sich selbst oder eines seiner eigenen Unterverzeichnisse oder das Kopieren eines Elements innerhalb desselben Verzeichnisses ohne Umbenennung.
DOMException.QUOTA_EXCEEDED_ERR-
Der Vorgang hat das Speicherlimit des Benutzers überschritten, oder es steht nicht genügend Speicherplatz zur Verfügung, um den Vorgang abzuschließen.
Beispiele
Dieses Beispiel zeigt, wie eine temporäre Protokolldatei in ein dauerhaftes "Protokoll"-Verzeichnis verschoben werden könnte.
workingDirectory.getFile(
"tmp/log.txt",
{},
(fileEntry) => {
workingDirectory.getDirectory(
"log",
{},
(dirEntry) => {
fileEntry.copyTo(dirEntry);
},
handleError,
);
},
handleError,
);