Dateien verwalten

Jede Methode auf dieser Seite liegt auf app.files:

const app = await api.applications.fetch("abc123def456abc123def456");
app.files; // FilesModule

Dateien in einem Verzeichnis auflisten

app.files.list(path?) gibt die Einträge eines Verzeichnisses zurück. Der Pfad ist standardmäßig "/".

const entries = await app.files.list("/");
console.log(entries);
// [
//   { type: "file",      name: "index.js", size: 123, lastModified: 1717084800000 },
//   { type: "directory", name: "src",      size: 0,   lastModified: 1717084800000 },
// ]

Eine Datei lesen

app.files.read(path) gibt einen Node.js-Buffer mit dem Dateiinhalt zurück oder undefined, wenn die Datei nicht vorhanden ist.

const buffer = await app.files.read("/index.js");
console.log(buffer?.toString("utf8"));

Das Lesen einer großen Datei schlägt mit FILE_TOO_LARGE (413) fehl.

Eine Datei erstellen oder überschreiben

app.files.create(file, fileName, path?) schreibt eine Datei nach path/fileName. Der Pfad ist standardmäßig "/".

Parameter	Typ	Beschreibung
`file`	`string \| Buffer`	Ein lokaler Dateipfad oder der rohe `Buffer`-Inhalt
`fileName`	`string`	Dateiname mit Erweiterung (z. B. `"version.ts"`)
`path`	`string`	Absoluter Verzeichnispfad innerhalb der App (Standard `"/"`)

Aus einem Buffer
Aus einem lokalen Pfad

const content = Buffer.from("export default 1\n");
await app.files.create(content, "version.ts", "/src");

import { join } from "node:path";

const localPath = join(__dirname, "version.ts");
await app.files.create(localPath, "version.ts", "/src");

Die Signatur hat sich in v4 geändert. Frühere Versionen akzeptierten create(content, fullPath) — v4 erfordert create(content, fileName, path).

Eine Datei bearbeiten

app.files.edit(file, path) überschreibt den Inhalt einer bestehenden Datei unter path.

Parameter	Typ	Beschreibung
`file`	`string \| Buffer`	Ein lokaler Dateipfad oder der rohe `Buffer`-Inhalt
`path`	`string`	Absoluter Pfad der zu überschreibenden Datei

const content = Buffer.from("export default 2\n");
await app.files.edit(content, "/src/version.ts");

Eine Datei verschieben oder umbenennen

app.files.move(path, newPath) verschiebt oder benennt eine Datei oder ein Verzeichnis um.

await app.files.move("/version.ts", "/src/version.ts");

Eine Datei oder ein Verzeichnis löschen

app.files.delete(path) löscht eine Datei oder ein gesamtes Verzeichnis.

await app.files.delete("/src/version.ts");

Dienste

Runtimes

Plattform

Fehlerbehebung

CLI

SDKs

Changelog

Dateien in einem Verzeichnis auflisten

Eine Datei lesen

Eine Datei erstellen oder überschreiben

Eine Datei bearbeiten

Eine Datei verschieben oder umbenennen

Eine Datei oder ein Verzeichnis löschen

​Dateien in einem Verzeichnis auflisten

​Eine Datei lesen

​Eine Datei erstellen oder überschreiben

​Eine Datei bearbeiten

​Eine Datei verschieben oder umbenennen

​Eine Datei oder ein Verzeichnis löschen

Dateien in einem Verzeichnis auflisten

Eine Datei lesen

Eine Datei erstellen oder überschreiben

Eine Datei bearbeiten

Eine Datei verschieben oder umbenennen

Eine Datei oder ein Verzeichnis löschen