Lese/Schreib-Dateien handhaben
Ordner erstellen
boolean fs.mkdir(strPath);
Erstellt im angegebenen Pfad einen Ordner, sofern dieser nicht bereits vorhanden ist. Gibt true bei Erfolg und false bei Fehler zurück.
| Parameter | Beschreibung |
|---|---|
| strPath | Pfad-Zeichenfolge |
Ordner entfernen
boolean fs.rmdir(dirPath);
Entfernt das Verzeichnis bei strPath, wenn es vorhanden und leer ist. Gibt true bei Erfolg und false bei Fehler zurück.
| Parameter | Beschreibung |
|---|---|
| dirPath | Ordner-Zeichenfolge |
Liest Ordnerinhalt
object fs.readdir(dirPath);
Liest Inhalte von einem Ordner. Gibt ein Array mit den Namen der Dateien im Ordner zurück, wobei '.' und '..'. ausgeschlossen werden. ausgeschlossen werden. Gibt bei einem Fehler eine leere Liste zurück.
| Parameter | Beschreibung |
|---|---|
| dirPath | Ordner-Zeichenfolge |
Datei lesen
object fs.readFile(strfile [,strFlag]);
Öffnet die Datei strFile im Lesemodus, liest ihren Inhalt und gibt ihn zurück.
| Parameter | Beschreibung |
|---|---|
| strFile | Dateiname-Zeichenfolge |
| strFlag | Datei-Lesemodus: „b“ liest und gibt eine Binärdatei zurück (andernfalls wird eine Textdatei zurückgegeben) |
Datei schreiben
fs.writeFile(strFile, fileData, [strFlag]);
Erstellt die Datei strFile file, sofern sie nicht vorhanden ist. Öffnet die Datei strFile file im Schreibmodus und schreibt die Daten fileData in die Datei.
| Parameter | Beschreibung |
|---|---|
| strFile | Dateiname-Zeichenfolge |
| fileData | Die in die Datei aus einem byte-Array zu schreibenden Daten |
| strFlag |
Datei-Schreibmodus:
|
Das Standard-Kennzeichen ist für das Schreiben der Textdatei im Anfüge- und Schreibmodus. Der Dateipfad wird, falls er noch nicht vorhanden ist, erstellt.
Gibt -1 zurück, wenn ein Schreibfehler auftritt.
An Datei anfügen
int fs.appendFile(strFile, fileData);
Wenn die Datei nicht existiert, wird sie erstellt, ansonsten an eine bestehende Datei angefügt. Gibt die Anzahl der geschriebenen Zeichen oder bei Fehler -1 zurück.
| Parameter | Beschreibung |
|---|---|
| strFile | Dateiname-Zeichenfolge |
| fileData |
Die in die Datei aus einem byte-Array zu schreibenden Daten |
Datei ist vorhanden
boolean fs.exists(strPath)
Gibt true zurück, wenn die Datei oder der Ordner im Pfad strPath existieren.
| Parameter | Beschreibung |
|---|---|
| strPath | Pfad-Zeichenfolge |
Datei entfernen
boolean fs.unlink(strPath)
Entfernt die gegebene Datei im Pfad strPath aus dem Dateisystem, sofern vorhanden. Gibt true bei Erfolg und false bei Fehler zurück.
| Parameter | Beschreibung |
|---|---|
| strPath | Pfad-Zeichenfolge |
Dateistatus
object fs.stat(strPath)
Ruft Informationen über die Datei/denOrdner am angegebenen Pfad ab.
| Parameter | Beschreibung |
|---|---|
| strPath | Datei-/Ordnerpfad-Zeichenfolge |
var fileStats = var fs.stat(strPath)
| fileStats.isFile |
True, wenn Pfad eine Datei ist |
| fileStats.isDir |
True, wenn Pfad ein Ordner ist |
| fileStats.size |
Größe der Datei in bytes |
| fileStats.atime |
Datumsobjekt, das die letzte Lesezugriffszeit enthält |
| fileStats.mtime | Datumsobjekt, das die letzte Schreibzugriffszeit enthält |
| fileStats.ctime |
Datumsobjekt, das die Zeit der Erstellung enthält |
| fileStats.perm | Dateiberechtigungen |
Wenn der Pfad ungültig ist, geben beide, isFile und isDir false zurück.
Dateiberechtigungstabelle
| 0x4000 | Die Datei kann vom Dateibesitzer gelesen werden |
| 0x2000 | In die Datei kann vom Dateibesitzer geschrieben werden |
| 0x1000 | Die Datei kann vom Dateibesitzer ausgeführt werden |
| 0x0400 | Die Datei kann vom Benutzer gelesen werden |
| 0x0200 | In die Datei kann vom Benutzer geschrieben werden |
| 0x0100 | Die Datei kann vom Benutzer ausgeführt werden |
| 0x0040 | Die Datei kann von der Gruppe gelesen werden |
| 0x0020 | In die Datei kann von der Gruppe geschrieben werden |
| 0x0010 | Die Datei kann von der Gruppe ausgeführt werden |
| 0x0004 | Die Datei kann von jedem gelesen werden |
| 0x0002 | In die Datei kann jeder schreiben |
Wichtige Hinweise zur Dateihandhabung
Der Datei- und Ordnerpfad wird im UNIX Format erwartet. Dies bedeutet, dass das Backslash-Zeichen (\) nicht erkannt wird. Benutzen Sie stattdessen den Schrägstrich (/).
Dateisystemobjekt ist ein Client-Seitenobjekt. Operationen werden auf dem lokalen Dateisystem und nicht auf dem Server-Dateisystem ausgeführt.
Das aktuelle JavaScript API wurde entwickelt, um den Zugriff auf das Geräte-Dateisystem zu erhalten und um kleine Dateien zu bearbeiten. Wenn eine Datei gelesen wird, wird der gesamte Dateiinhalt vorübergehend im für die JavaScript-Umgebung (16 MB) verfügbaren RAM gespeichert und es wird eine Ausnahme ausgelöst, wenn nicht genügend Speicher zur Verfügung steht. Eine gute Programmierpraktik ist das Einschließen des Aufrufs fs.readFile() in einem try/catch-Block.