---
url: 'https://elysiajs.com/plugins/server-timing.md'
---

# 服务器计时插件

该插件支持通过服务器计时 API 审计性能瓶颈

安装方法：

```bash
bun add @elysiajs/server-timing
```

然后使用它：

```typescript twoslash
import { Elysia } from 'elysia'
import { serverTiming } from '@elysiajs/server-timing'

new Elysia()
    .use(serverTiming())
    .get('/', () => 'hello')
    .listen(3000)
```

然后，服务器计时将附加 'Server-Timing' 头，记录每个生命周期函数的持续时间、函数名称和细节。

要检查，请打开浏览器开发者工具 > 网络 > \[通过 Elysia 服务器发出的请求] > 时序。

![开发者工具显示的服务器计时截图](/assets/server-timing.webp)

现在，您可以轻松审计服务器的性能瓶颈。

## 配置

以下是插件接受的配置

### enabled

@default `NODE_ENV !== 'production'`

确定是否启用服务器计时

### allow

@default `undefined`

一个条件，决定是否记录服务器计时

### trace

@default `undefined`

允许服务器计时记录指定的生命周期事件：

Trace 接受以下对象：

* request: 捕获请求的持续时间
* parse: 捕获解析的持续时间
* transform: 捕获转化的持续时间
* beforeHandle: 捕获处理前的持续时间
* handle: 捕获处理的持续时间
* afterHandle: 捕获处理后的持续时间
* total: 捕获从开始到结束的总持续时间

## 模式

下面您可以找到使用插件的常见模式。

* [允许条件](#allow-condition)

## 允许条件

您可以通过 `allow` 属性在特定路由上禁用服务器计时

```ts twoslash
import { Elysia } from 'elysia'
import { serverTiming } from '@elysiajs/server-timing'

new Elysia()
    .use(
        serverTiming({
            allow: ({ request }) => {
                return new URL(request.url).pathname !== '/no-trace'
            }
        })
    )
```