Gerenciando arquivos

Todos os métodos desta página estão em app.files:

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

Listando arquivos de um diretório

app.files.list(path?) retorna as entradas de um diretório. O caminho padrão é "/".

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

Lendo um arquivo

app.files.read(path) retorna um Buffer do Node.js com o conteúdo do arquivo, ou undefined quando o arquivo não existe.

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

Ler um arquivo grande falha com FILE_TOO_LARGE (413).

Criando ou sobrescrevendo um arquivo

app.files.create(file, fileName, path?) cria um arquivo em path/fileName. O caminho padrão é "/".

Parâmetro	Tipo	Descrição
`file`	`string \| Buffer`	Caminho local do arquivo ou conteúdo como `Buffer`
`fileName`	`string`	Nome do arquivo com extensão (ex.: `"version.ts"`)
`path`	`string`	Caminho absoluto do diretório dentro da aplicação (padrão `"/"`)

A partir de Buffer
A partir de caminho 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");

A assinatura mudou na v4. Versões anteriores aceitavam create(content, fullPath) — a v4 exige create(content, fileName, path).

Editando um arquivo

app.files.edit(file, path) sobrescreve o conteúdo de um arquivo existente em path.

Parâmetro	Tipo	Descrição
`file`	`string \| Buffer`	Caminho local do arquivo ou conteúdo em `Buffer`
`path`	`string`	Caminho absoluto do arquivo a ser sobrescrito

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

Movendo ou renomeando um arquivo

app.files.move(path, newPath) move ou renomeia um arquivo ou diretório.

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

Excluindo um arquivo ou diretório

app.files.delete(path) apaga um arquivo ou um diretório inteiro.

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

Serviços

Runtimes

Plataforma

Solução de Problemas

CLI

SDKs

Changelog

Listando arquivos de um diretório

Lendo um arquivo

Criando ou sobrescrevendo um arquivo

Editando um arquivo

Movendo ou renomeando um arquivo

Excluindo um arquivo ou diretório

​Listando arquivos de um diretório

​Lendo um arquivo

​Criando ou sobrescrevendo um arquivo

​Editando um arquivo

​Movendo ou renomeando um arquivo

​Excluindo um arquivo ou diretório

Listando arquivos de um diretório

Lendo um arquivo

Criando ou sobrescrevendo um arquivo

Editando um arquivo

Movendo ou renomeando um arquivo

Excluindo um arquivo ou diretório