Gestión de archivos

Todos los métodos de esta página residen en app.files:

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

Listado de archivos en un directorio

app.files.list(path?) devuelve las entradas de un directorio. La ruta por defecto es "/".

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 },
// ]

Lectura de un archivo

app.files.read(path) devuelve un Buffer de Node.js con el contenido del archivo, o undefined cuando el archivo no existe.

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

Leer un archivo grande falla con FILE_TOO_LARGE (413).

Creación o sobrescritura de un archivo

app.files.create(file, fileName, path?) escribe un archivo en path/fileName. La ruta por defecto es "/".

Parámetro	Tipo	Descripción
`file`	`string \| Buffer`	Una ruta de archivo local o el contenido `Buffer` sin procesar
`fileName`	`string`	Nombre del archivo con extensión (p. ej. `"version.ts"`)
`path`	`string`	Ruta de directorio absoluta dentro de la aplicación (por defecto `"/"`)

Desde un Buffer
Desde una ruta 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 firma cambió en la v4. Las versiones anteriores aceptaban create(content, fullPath); la v4 requiere create(content, fileName, path).

Edición de un archivo

app.files.edit(file, path) sobrescribe el contenido de un archivo existente en path.

Parámetro	Tipo	Descripción
`file`	`string \| Buffer`	Una ruta de archivo local o el contenido `Buffer` sin procesar
`path`	`string`	Ruta absoluta del archivo a sobrescribir

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

Mover o renombrar un archivo

app.files.move(path, newPath) mueve o renombra un archivo o directorio.

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

Eliminación de un archivo o directorio

app.files.delete(path) elimina un archivo o un directorio completo.

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

Servicios

Runtimes

Plataforma

Solución de problemas

CLI

SDKs

Changelog

Listado de archivos en un directorio

Lectura de un archivo

Creación o sobrescritura de un archivo

Edición de un archivo

Mover o renombrar un archivo

Eliminación de un archivo o directorio

​Listado de archivos en un directorio

​Lectura de un archivo

​Creación o sobrescritura de un archivo

​Edición de un archivo

​Mover o renombrar un archivo

​Eliminación de un archivo o directorio

Listado de archivos en un directorio

Lectura de un archivo

Creación o sobrescritura de un archivo

Edición de un archivo

Mover o renombrar un archivo

Eliminación de un archivo o directorio