> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Variabili d'ambiente

> Elenca, aggiungi, sostituisci ed elimina le variabili d'ambiente di un'applicazione.

`app.envs` espone il modulo [`EnvsModule`](https://github.com/squarecloudofc/sdk-api-js/blob/main/src/modules/envs.ts), che ti consente di gestire le coppie `KEY=value` che la tua applicazione vede a runtime.

```typescript theme={null}
const app = await api.applications.fetch("abc123def456abc123def456");
app.envs; // EnvsModule
```

Ogni metodo si risolve nell'intero insieme di variabili d'ambiente dopo il completamento dell'operazione, così ottieni sempre una mappa `{ key: value }` aggiornata.

## Elencare le variabili d'ambiente

```typescript theme={null}
const envs = await app.envs.list();

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

## Aggiungere o aggiornare variabili

`app.envs.set(envs)` unisce le nuove variabili all'insieme esistente. Le chiavi esistenti non presenti nella chiamata vengono preservate.

```typescript theme={null}
await app.envs.set({
    DATABASE_URL: "postgres://...",
    FEATURE_FLAG: "true",
});
```

## Sostituire l'intero insieme di variabili

`app.envs.replace(envs)` sovrascrive ogni variabile. Tutto ciò che non è elencato viene **rimosso**.

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

Passa un oggetto vuoto per cancellare tutte le variabili:

```typescript theme={null}
await app.envs.replace({});
```

## Eliminare variabili

`app.envs.delete(keys)` rimuove le chiavi elencate. Le chiavi sconosciute vengono ignorate silenziosamente.

```typescript theme={null}
await app.envs.delete(["FEATURE_FLAG"]);
```