Ogni metodo di questa pagina risiede in app.files:
const app = await api.applications.fetch("abc123def456abc123def456");
app.files; // FilesModule
Elencare i file di una directory
app.files.list(path?) restituisce le voci di una directory. Il percorso predefinito è "/".
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 },
// ]
Leggere un file
app.files.read(path) restituisce un Buffer di Node.js con il contenuto del file, oppure undefined quando il file non esiste.
const buffer = await app.files.read("/index.js");
console.log(buffer?.toString("utf8"));
Creare o sovrascrivere un file
app.files.create(file, fileName, path?) scrive un file in path/fileName. Il percorso predefinito è "/".
| Parametro | Tipo | Descrizione |
|---|
file | string | Buffer | Un percorso di file locale o il contenuto grezzo come Buffer |
fileName | string | Nome del file con estensione (es. "version.ts") |
path | string | Percorso assoluto della directory all’interno dell’app (predefinito "/") |
Da un Buffer
Da un percorso locale
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 firma è cambiata nella v4. Le versioni precedenti accettavano create(content, fullPath): la v4 richiede create(content, fileName, path).
Spostare o rinominare un file
app.files.move(path, newPath) sposta o rinomina un file o una directory.
await app.files.move("/version.ts", "/src/version.ts");
Eliminare un file o una directory
app.files.delete(path) elimina un file o un’intera directory.
await app.files.delete("/src/version.ts");