Gérer les fichiers

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"));

La lecture d’un fichier volumineux échoue avec FILE_TOO_LARGE (413).

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).

Modifier un fichier

app.files.edit(file, path) écrase le contenu d’un fichier existant à l’emplacement path.

Paramètre	Type	Description
`file`	`string \| Buffer`	Un chemin de fichier local ou le contenu brut sous forme de `Buffer`
`path`	`string`	Chemin absolu du fichier à écraser

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

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");

Services

Runtimes

Plateforme

Dépannage

CLI

SDKs

Changelog

Lister les fichiers d’un répertoire

Lire un fichier

Créer ou écraser un fichier

Modifier un fichier

Déplacer ou renommer un fichier

Supprimer un fichier ou un répertoire

​Lister les fichiers d’un répertoire

​Lire un fichier

​Créer ou écraser un fichier

​Modifier un fichier

​Déplacer ou renommer un fichier

​Supprimer un fichier ou un répertoire

Lister les fichiers d’un répertoire

Lire un fichier

Créer ou écraser un fichier

Modifier un fichier

Déplacer ou renommer un fichier

Supprimer un fichier ou un répertoire