# Variables de entorno

> Comparte datos entre scripts de Proxyman con sharedState y lee variables de entorno del sistema, como tokens de API, en tus scripts con el prefijo $.

## 1. Estado compartido {#1-shared-state}

> **Nota:** El estado compartido funciona en todas las versiones de macOS que admite Proxyman (**macOS 14 Sonoma o posterior**).

Puedes compartir estado entre **onRequest()** y **onResponse()**, y entre **scripts diferentes**, con el objeto global **sharedState**.

* **sharedState** es un objeto JS (diccionario). Puedes asignar cualquier clave y valor en **onRequest()** y luego leer los datos en **onResponse()** o en **scripts diferentes**.

El siguiente código muestra cómo:

* Obtener el contador global y aumentarlo cada vez que se ejecuta el script
* Compartir datos entre la solicitud y la respuesta

```javascript
function onRequest(context, url, request) {

  // Save some state to sharedState
  sharedState.url = url;
  sharedState.data = "custom";
  sharedState.info = {"username": "Proxyman"};
  
  // Increase the global counter
  var count = sharedState.count ?? 0;
  count += 1;
  sharedState.count = count;
  
  // Log
  console.log(sharedState);
  return request;
}

function onResponse(context, url, request, response) {

  // Receive it
  console.log("Custom data = " + sharedState.data);
  console.log("sharedState.count = " + sharedState.count);
  
  // Done
  return response;
}
```

> **Nota:** Desde Proxyman 2.25.0, **sharedState** está disponible entre scripts diferentes. Solo se libera cuando sales de Proxyman o llamas a la función \`clearSharedState()\`.

> **Nota:** Antes de Proxyman 2.24.0, **sharedState** solo existía en el flujo actual que ejecuta el script, y se liberaba cuando el script terminaba.

Para borrar todos los datos, usa la función \`clearSharedState()\`.

```javascript
// Clear all data from sharedState object
clearSharedState();
```

## 2. Variables de entorno {#2-environment-variables}

La función Environment Variables está disponible desde **Proxyman 3.8.0** o posterior.

* Los scripts pueden leer las variables de entorno del sistema.
* Compatible con bash y zsh.

### Cómo usar {#how-to-use}

1. Define una variable de entorno en tu `~/.zshrc` o `~/.bashrc`

```bash
export ACCESS_TOKEN=AAABBBCCC
export PROXYMAN_PATH=/Users/my_user/Desktop/file-mapper
```

2\. Abre cualquier script -> botón **More** -> **Environment Variables** -> **Allow all scripts to access Environment Variables**.

3\. Haz clic en **Reload** para cargar los últimos cambios del entorno.

![Menú More del editor de scripts de Proxyman con Environment Variables abierto: opciones Allow all scripts to access Environment Variables y Reload](https://proxyman.com/docs/assets/proxyman-script-environment-variables-menu.jpg)

_Permite que los scripts lean las variables de entorno_

4\. Accede a una variable de entorno en tu script con el prefijo `$`

```javascript
async function onResponse(context, url, request, response) {
  console.log($PATH);
  console.log($ACCESS_TOKEN);
  console.log($PROXYMAN_PATH);
 
  // Done
  return response;
}
```

## 3. Funciones adicionales {#3-additions}

* Recarga manualmente el entorno del sistema (Proxyman macOS 4.15.0 o posterior). Activa primero el permiso: botón **More** -> **Environment Variables** -> **Allow all scripts to access Environment Variables**.

```javascript
async function onRequest(context, url, request) {
  // manually reload to get the latest changes
  _reloadEnv();
  
  // get env
  console.log($PROXYMAN_ID)
  
  // Done
  return request;
}

```