FileEntry
Rappresenta un file su un file system, come definito nella specifica W3C directory e sistemi .
Proprietà
isFile: sempre
true
. (booleano)isDirectory: sempre
false
. (booleano)nome: il nome della
FileEntry
, escludendo il sentiero che conduce ad esso. (DOMString)fullPath: il percorso completo assoluto dalla radice per il
FileEntry
. (DOMString)
Nota: Il seguente attributo è definito nella specifica W3C, ma non è supportato:
- filesystem: il filesystem su cui il
FileEntry
risiede. (FileSystem)
Metodi
getMetadata: cercare i metadati relativi a un file.
setMetadata: impostare i metadati in un file.
moveTo: spostare un file in una posizione diversa del file System.
copyTo: copiare un file in un'altra posizione nel file System.
toURL: restituire un URL che può essere utilizzato per individuare un file.
rimuovere: eliminare un file.
getParent: cercare la directory padre.
createWriter: crea un
[FileWriter](../filewriter/filewriter.html)
che può essere utilizzato per scrivere in un file.file: crea un
[File](../fileobj/fileobj.html)
oggetto contenente le proprietà del file.
Piattaforme supportate
- Android
- BlackBerry WebWorks (OS 5.0 e superiori)
- iOS
- Windows Phone 7 e 8
- Windows 8
getMetadata
Cercare i metadati relativi a un file.
Parametri:
successCallback: un callback passato un
Metadata
oggetto. (Funzione)errorCallback: un callback che viene eseguito se si verifica un errore durante il recupero del
Metadata
. Invocato con un[FileError](../fileerror/fileerror.html)
oggetto. (Funzione)
Esempio rapido
funzione success(metadata) {console ("ultima modifica:" + metadata.modificationTime);}
funzione fail(error) {alert(error.code)};
/ / Richiesta oggetto dei metadati per questa voce entry.getMetadata (successo, fail);
setMetadata
Metadati impostati su un file.
Attualmente funziona solo su iOS.
- Questo imposterà gli attributi estesi di un file.
Parametri:
successCallback: un callback che viene eseguito quando i metadati sono impostato. (Funzione)
errorCallback: un callback che viene eseguito quando i metadati non sono impostato correttamente. (Funzione)
per il metadataObject: un oggetto che contiene dei metadati chiavi e valori. (Oggetto)
Esempio rapido
function success() {
console.log("The metadata was successfully set.");
}
function fail() {
alert("There was an error in setting the metadata");
}
// Set the metadata
entry.setMetadata(success, fail, { "com.apple.MobileBackup": 1});
iOS Quirk
- Solo il
com.apple.MobileBackup
attributo esteso è supportato. Impostare il valore1
per impedire il file di backup a iCloud. Impostare il valore `` per abilitare nuovamente il file di backup a iCloud.
Esempio rapido
function setFileMetadata(localFileSystem, filePath, metadataKey, metadataValue)
{
var onSetMetadataWin = function() {
console.log("success setting metadata")
}
var onSetMetadataFail = function() {
console.log("error setting metadata")
}
var onGetFileWin = function(parent) {
var data = {};
data[metadataKey] = metadataValue;
parent.setMetadata(onSetMetadataWin, onSetMetadataFail, data);
}
var onGetFileFail = function() {
console.log("error getting file")
}
var onFSWin = function(fileSystem) {
fileSystem.root.getFile(filePath, {create: true, exclusive: false}, onGetFileWin, onGetFileFail);
}
var onFSFail = function(evt) {
console.log(evt.target.error.code);
}
window.requestFileSystem(localFileSystem, 0, onFSWin, onFSFail);
}
setFileMetadata(LocalFileSystem.PERSISTENT, "Backups/sqlite.db", "com.apple.MobileBackup", 1);
moveTo
Spostare un file in una posizione diversa del file System. Un errore risultati se tenta di app:
spostare un file nel suo padre se non è fornito un nome diverso dal suo attuale uno;
spostare un file in un percorso occupato da una directory;
Inoltre, lo spostamento di un file in cima a un file esistente tenta di eliminare e sostituire quel file.
Parametri:
padre: directory superiore, per cui spostare il file. (DirectoryEntry)
newName: il nuovo nome del file. Impostazioni predefinite per il nome attuale, se non specificato. (DOMString)
successCallback: un callback passato il nuovo file
FileEntry
oggetto. (Funzione)errorCallback: un callback che viene eseguito se si verifica un errore quando si tenta di spostare il file. Invocato con un
[FileError](../fileerror/fileerror.html)
oggetto. (Funzione)
Esempio rapido
function success(entry) {
console.log("New Path: " + entry.fullPath);
}
function fail(error) {
alert(error.code);
}
function moveFile(entry) {
var parent = document.getElementById('parent').value,
parentName = parent.substring(parent.lastIndexOf('/')+1),
parentEntry = new DirectoryEntry(parentName, parent);
// move the file to a new directory and rename it
entry.moveTo(parentEntry, "newFile.txt", success, fail);
}
copyTo
Copiare un file in una nuova posizione nel file System. Un errore risultati se tenta di app:
- copiare un file in suo padre, se non viene fornito un nome diverso dal suo attuale uno.
Parametri:
padre: la directory genitore in cui copiare il file. (DirectoryEntry)
newName: il nuovo nome del file. Impostazioni predefinite per il nome attuale, se non specificato. (DOMString)
successCallback: un callback passato il nuovo file
FileEntry
oggetto. (Funzione)errorCallback: un callback che viene eseguito se si verifica un errore quando si tenta di copiare il file. Invocato con un
[FileError](../fileerror/fileerror.html)
oggetto. (Funzione)
Esempio rapido
function win(entry) {
console.log("New Path: " + entry.fullPath);
}
function fail(error) {
alert(error.code);
}
function copyFile(entry) {
var parent = document.getElementById('parent').value,
parentName = parent.substring(parent.lastIndexOf('/')+1),
parentEntry = new DirectoryEntry(parentName, parent);
// copy the file to a new directory and rename it
entry.copyTo(parentEntry, "file.copy", success, fail);
}
toURL
Restituisce un URL che può essere utilizzato per individuare il file.
Esempio rapido
// Request the URL for this entry
var fileURL = entry.toURL();
console.log(fileURL);
rimuovere
Elimina un file.
Parametri:
successCallback: un callback che viene eseguito dopo che il file è stato eliminato. Richiamato senza parametri. (Funzione)
errorCallback: un callback che viene eseguito se si verifica un errore quando si tenta di eliminare il file. Invocato con un
[FileError](../fileerror/fileerror.html)
oggetto. (Funzione)
Esempio rapido
function success(entry) {
console.log("Removal succeeded");
}
function fail(error) {
alert('Error removing file: ' + error.code);
}
// remove the file
entry.remove(success, fail);
getParent
Cercare il padre [DirectoryEntry](../directoryentry/directoryentry.html)
che contiene il file.
Parametri:
successCallback: un callback passato padre del file
[DirectoryEntry](../directoryentry/directoryentry.html)
. (Funzione)errorCallback: un callback che viene eseguito se si verifica un errore quando si tenta di recuperare il padre
[DirectoryEntry](../directoryentry/directoryentry.html)
. Invocato con un[FileError](../fileerror/fileerror.html)
oggetto. (Funzione)
Esempio rapido
function success(parent) {
console.log("Parent Name: " + parent.name);
}
function fail(error) {
alert(error.code);
}
// Get the parent DirectoryEntry
entry.getParent(success, fail);
createWriter
Creare un [FileWriter](../filewriter/filewriter.html)
oggetto associato al file rappresentato dallaFileEntry
.
Parametri:
successCallback: un callback passato un
[FileWriter](../filewriter/filewriter.html)
oggetto. (Funzione)errorCallback: un callback che viene eseguito se si verifica un errore durante il tentativo di creare il FileWriter. Invocato con un
[FileError](../fileerror/fileerror.html)
oggetto. (Funzione)
Esempio rapido
function success(writer) {
writer.write("Some text to the file");
}
function fail(error) {
alert(error.code);
}
// create a FileWriter to write to the file
entry.createWriter(success, fail);
file
Restituire un [File](../fileobj/fileobj.html)
oggetto che rappresenta lo stato corrente del file che questa FileEntry
rappresenta.
Parametri:
successCallback: un callback passato un
[File](../fileobj/fileobj.html)
oggetto. (Funzione)errorCallback: un callback che viene eseguito se si verifica un errore durante la creazione del
[File](../fileobj/fileobj.html)
oggetto, ad esempio quando il file non esiste più. Invocato con un[FileError](../fileerror/fileerror.html)
oggetto. (Funzione)
Esempio rapido
function success(file) {
console.log("File size: " + file.size);
}
function fail(error) {
alert("Unable to retrieve file properties: " + error.code);
}
// obtain properties of a file
entry.file(success, fail);