Chaque méthode de cette page réside sur app.files :
const app = await api.applications.fetch("abc123def456abc123def456");
app.files; // FilesModule
Lister les fichiers d’un répertoire
app.files.list(path?) renvoie les entrées d’un répertoire. Le chemin par défaut est "/".
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 },
// ]
Lire un fichier
app.files.read(path) renvoie un Buffer Node.js contenant le contenu du fichier, ou undefined lorsque le fichier est absent.
const buffer = await app.files.read("/index.js");
console.log(buffer?.toString("utf8"));
Créer ou écraser un fichier
app.files.create(file, fileName, path?) écrit un fichier à l’emplacement path/fileName. Le chemin par défaut est "/".
| Paramètre | Type | Description |
|---|
file | string | Buffer | Un chemin de fichier local ou le contenu brut sous forme de Buffer |
fileName | string | Nom du fichier avec extension (ex. "version.ts") |
path | string | Chemin absolu du répertoire dans l’application (par défaut "/") |
Depuis un Buffer
Depuis un chemin local
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");
La signature a changé en v4. Les versions précédentes acceptaient create(content, fullPath) — la v4 requiert create(content, fileName, path).
Déplacer ou renommer un fichier
app.files.move(path, newPath) déplace ou renomme un fichier ou un répertoire.
await app.files.move("/version.ts", "/src/version.ts");
Supprimer un fichier ou un répertoire
app.files.delete(path) supprime un fichier ou un répertoire entier.
await app.files.delete("/src/version.ts");
