test-server：快速搭建测试 HTTP 和 WebSocket 服务器

最新推荐文章于 2025-05-09 17:53:03 发布

卢红梓

最新推荐文章于 2025-05-09 17:53:03 发布

阅读量1k

点赞数 24

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00837/article/details/147570215

test-server：快速搭建测试 HTTP 和 WebSocket 服务器

test-server Utility for creating HTTP and WebSocket servers for testing. 项目地址: https://gitcode.com/gh_mirrors/tes/test-server

项目介绍

在现代网络应用程序开发中，测试是确保软件质量的关键步骤。test-server 是一个开源实用工具，它允许开发者快速创建 HTTP 和 WebSocket 服务器进行测试。该工具旨在最小化测试设置，自动处理服务器资源的释放，并基于标准的网络协议来处理请求和响应。

项目技术分析

test-server 使用 TypeScript 编写，利用了 TypeScript 5.2 中的 using 关键字，使得创建的服务器实例能够在不再被引用时自动关闭，从而避免资源泄漏。此外，该工具利用了 Hono 库来创建服务器，Hono 是一个无服务器架构的 HTTP 框架，它轻量级且易于使用。

核心特性

轻量级: 按需创建服务器实例，保持测试环境简洁。
自动释放: 服务器实例在不再被使用时自动关闭。
基于标准: 使用 Web 标准（如 HTTP/1.1、WebSocket）处理请求和响应。

项目及技术应用场景

test-server 适用于多种开发场景，尤其是当你需要进行单元测试或集成测试时：

单元测试: 在测试中创建一个临时的 HTTP 或 WebSocket 服务器，以模拟外部服务。
集成测试: 验证应用程序的 HTTP 和 WebSocket 端点是否符合预期。
模拟服务: 在没有实际服务端时，模拟服务端的行为。

下面，我们将详细介绍如何使用 test-server 来创建 HTTP 和 WebSocket 服务器。

创建 HTTP 服务器

import { createTestHttpServer } from '@epic-web/test-server/http'

it('fetches the list of numbers', async () => {
  await using server = await createTestHttpServer({
    defineRoutes(router) {
      router.get('/numbers', () => {
        return Response.json([1, 2, 3])
      })
    }
  })

  const response = await fetch(server.http.url('/numbers'))
  await expect(response.json()).resolves.toEqual([1, 2, 3])
})

在这个例子中，我们创建了一个 HTTP 服务器，并定义了一个路由来返回数字列表。然后，我们使用 fetch 来请求数字列表，并验证响应是否符合预期。

创建 WebSocket 服务器

import { createTestHttpServer } from '@epic-web/test-server/http'
import { createWebSocketMiddleware } from '@epic-web/test-server/ws'

it('handles WebSocket communication', async () => {
  await using server = await createTestHttpServer()
  await using wss = createWebSocketMiddleware({ server })

  wss.ws.on('connect', (socket) => console.log('new connection!'))

  const client = new WebSocket(wss.ws.url())
})

在这个例子中，我们创建了一个 WebSocket 服务器，并添加了一个事件监听器来处理连接事件。