# 环境变量

> 使用 sharedState 在 Proxyman 脚本之间共享数据，并在脚本中通过 $ 前缀读取 API Token 等系统环境变量。

## 1. 共享状态 {#1-shared-state}

> **备注:** 共享状态适用于 Proxyman 支持的所有 macOS 版本（**macOS 14 Sonoma 或更高版本**）。

你可以通过全局对象 **sharedState**，在 **onRequest()** 和 **onResponse()** 之间，以及**不同脚本**之间共享状态。

* **sharedState** 是一个 JS 对象（字典）。你可以在 **onRequest()** 中设置任意键和值，然后在 **onResponse()** 或**不同脚本**中读取数据。

以下代码演示了如何：

* 获取全局计数器，并在每次脚本运行时将其递增
* 在请求与响应之间共享数据

```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;
}
```

> **备注:** 从 Proxyman 2.25.0 开始，**sharedState** 可以在不同脚本之间使用。只有在退出 Proxyman 或调用 \`clearSharedState()\` 函数时，数据才会被释放。

> **备注:** 在 Proxyman 2.24.0 之前，**sharedState** 仅在运行该脚本的当前流程中有效，脚本执行完毕后即被释放。

如需清除所有数据，请使用 \`clearSharedState()\` 函数。

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

## 2. 环境变量 {#2-environment-variables}

从 **Proxyman 3.8.0** 开始提供环境变量功能。

* 脚本可以读取系统环境变量。
* 支持 bash 和 zsh。

### 使用方法 {#how-to-use}

1. 在 `~/.zshrc` 或 `~/.bashrc` 中定义环境变量

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

2\. 打开任意脚本 -> **More** 按钮 -> **Environment Variables** -> **Allow all scripts to access Environment Variables**。

3\. 点击 **Reload**，加载最新的环境变量更改。

![Proxyman 脚本编辑器中展开 Environment Variables 的 More 菜单：Allow all scripts to access Environment Variables、Reload](https://proxyman.com/docs/assets/proxyman-script-environment-variables-menu.jpg)

_允许脚本读取环境变量_

4\. 在脚本中使用 `$` 前缀访问环境变量

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

## 3. 补充说明 {#3-additions}

* 手动重新加载系统环境变量（需要 Proxyman macOS 4.15.0 或更高版本）。请先开启权限：**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;
}

```