Gestire i file

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

La lettura di un file di grandi dimensioni fallisce con FILE_TOO_LARGE (413).

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

Modificare un file

app.files.edit(file, path) sovrascrive il contenuto di un file esistente in path.

Parametro	Tipo	Descrizione
`file`	`string \| Buffer`	Un percorso di file locale o il contenuto grezzo come `Buffer`
`path`	`string`	Percorso assoluto del file da sovrascrivere

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

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

Servizi

Runtimes

Piattaforma

Risoluzione dei problemi

CLI

SDKs

Changelog

Elencare i file di una directory

Leggere un file

Creare o sovrascrivere un file

Modificare un file

Spostare o rinominare un file

Eliminare un file o una directory

​Elencare i file di una directory

​Leggere un file

​Creare o sovrascrivere un file

​Modificare un file

​Spostare o rinominare un file

​Eliminare un file o una directory

Elencare i file di una directory

Leggere un file

Creare o sovrascrivere un file

Modificare un file

Spostare o rinominare un file

Eliminare un file o una directory