> For the complete documentation index, see [llms.txt](https://koipy.gitbook.io/koipy/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://koipy.gitbook.io/koipy/doc/miaospeed-hou-duan/ce-shi-jiao-ben-bian-xie/di-yi-ge-ce-shi-jiao-ben.md).

# 第一个测试脚本

我们使用一个 YouTube 脚本作为例子，该脚本可以测试节点是否可以使用 YouTube Premium：

```javascript
const C_NA = '142,140,142'; // N/A 不可用的颜色
const C_UNL = '186,230,126'; // 解锁的颜色
const C_FAIL = '239,107,115'; // 解锁失败的颜色
const C_UNK = '92,207,230'; // 解锁未知的颜色
const C_CN = '250,213,149'; // 其他颜色

function handler() {
    const content = fetch('https://www.youtube.com/premium', {
        headers: {
            'user-agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36',
            'accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7',
            'accept-language': 'en',
            'upgrade-insecure-requests': '1',
            'cookies': {
                'YSC': 'BiCUU3-5Gdk',
                'CONSENT': 'YES+cb.20220301-11-p0.en+FX+700',
                'GPS': '1',
                'VISITOR_INFO1_LIVE': '4VwPMkB7W5A',
                '_gcl_au': '1.1.1809531354.1646633279',
                'PREF': 'tz=Asia.Shanghai',
            },
        },
        noRedir: false,
        retry: 3,
        timeout: 5000,
    });

    if (!content) {
        return {
            text: 'N/A',
            background: C_NA,
        };
    } else if (content.statusCode == 200) {
        const body = content.body;

        if (/www.google.cn/.test(body)) {
            return {
                text: `送中 (CN)`,
                background: C_CN,
            };
        }

        if (/Premium is not available in your country/.test(body)) {
            return {
                text: '未知',
                background: C_UNK,
            };
        }

        let region = '未知';
        if (/"countryCode":"(.*?)"/.test(body)) {
            region = body.match(/"countryCode":"(.*?)"/)[1];
            return {
                text: `解锁 (${region.toUpperCase()})`,
                background: C_UNL,
            };
        }
        if (/YouTube and YouTube Music ad-free, offline, and in the background/.test(body)) {
            return {
                text: `解锁 (US)`,
                background: C_UNL,
            };
        }
        return {
            text: `解锁 (${region.toUpperCase()})`,
            background: C_UNK,
        };
    } else if (content.statusCode == 302) {
        return {
            text: `重定向`,
            background: C_UNL,
        };
    } else {
        return {
            text: '未知',
            background: C_UNK,
        };
    }
}
```

## 脚本分析

从以上例子可以看到，我们需要定义 `handler` 函数（必须是这个名称），它相当于程序入口。在 `handler` 函数里编写业务逻辑。

### 发起网络通信

使用 `fetch` 内置函数发起网络通信。在上面的例子里，通过调用 `fetch` 函数发起 GET 请求，返回响应体 **content**。请注意，ms 的 `fetch` 等内置函数是 Go 实现的，它不会返回 Promise 对象。响应数据通过：

```javascript
const body = content.body; // 拿到响应数据
```

### 返回值

`handler` 函数的返回值为一个 Object（对象）。但 MiaoSpeed 只会解析其中的三个键值对：

```javascript
{
    text: "解锁",
    background: C_UNK,
    color: C_UNK
}
```

* `text`：展示在绘图中的内容
* `background`：背景颜色，格式为 RGB，例如 `(255,255,255)`，koipy 不使用该值。
* `color`：意义暂不详，koipy 不使用该值。