Umgebungsvariablen - Square Cloud

app.envs stellt das EnvsModule bereit, mit dem du die KEY=value-Paare verwalten kannst, die deine Anwendung zur Laufzeit sieht.

const app = await api.applications.fetch("abc123def456abc123def456");
app.envs; // EnvsModule

Jede Methode löst nach Abschluss der Operation zum vollständigen Env-Set auf — du erhältst also stets eine aktuelle { key: value }-Map zurück.

Umgebungsvariablen auflisten

const envs = await app.envs.list();

console.log(envs);
// { DATABASE_URL: "postgres://...", FEATURE_FLAG: "true" }

app.envs.set(envs) führt neue Variablen in das bestehende Set zusammen. Vorhandene Schlüssel, die nicht im Aufruf enthalten sind, bleiben erhalten.

await app.envs.set({
    DATABASE_URL: "postgres://...",
    FEATURE_FLAG: "true",
});

app.envs.replace(envs) überschreibt jede Variable. Alles, was nicht aufgeführt ist, wird entfernt.

await app.envs.replace({
    DATABASE_URL: "postgres://new-host...",
});
// FEATURE_FLAG is now gone

Übergib ein leeres Objekt, um alle Variablen zu löschen:

await app.envs.replace({});

app.envs.delete(keys) entfernt die aufgeführten Schlüssel. Unbekannte Schlüssel werden stillschweigend ignoriert.

await app.envs.delete(["FEATURE_FLAG"]);