@alienplatform/testing

中文文档
3.3.54发布于 2026/11/05FSL-1.1-Apache-2.0TypeScriptES Module近 30 天下载 3799

异形应用程序测试框架

中文使用文档
文档目录7 节
  1. 安装
  2. 本地对云
  3. 本地模式
  4. 云模式
  5. API 密码
  6. 配置
  7. 页:1

@ alienplatform/ 测试

异形应用测试框架.

安装

npm install --save-dev @alienplatform/testing

本地对云

此软件包有两种部署模式:

  • 本地模式使用 alien dev
  • 云模式使用平台 API

这种分裂是故意的。 本地模式以已运出的模式为中心 alien CLI 二进制而不是要求用户发现下级管理器二进制.

本地模式

本地模式为默认 :

import { afterAll, beforeAll, describe, expect, it } from "vitest"
import { deploy, type Deployment } from "@alienplatform/testing"

describe("My App", () => {
  let deployment: Deployment

  beforeAll(async () => {
    deployment = await deploy({ app: "./my-app" })
  }, 300_000)

  afterAll(async () => {
    await deployment?.destroy()
  })

  it("responds to requests", async () => {
    const response = await fetch(`${deployment.url}/api/hello`)
    expect(response.status).toBe(200)
  })
})

在头罩下,包裹:

  1. 发现 alien 二进制
  2. 产卵 alien dev --status-file ...
  3. 等待状态文件报告准备状态
  4. 从该文件读取公共 URL并命令 URL

本地机器合同是 DevStatus JSON 撰写人: alien dev,而不是终端输出.

云模式

云模式瞄准真正的基础设施:

const deployment = await deploy({
  app: "./my-app",
  platform: "aws",
})

支持的云平台:

  • aws
  • gcp
  • azure

云模式需要 ALIEN_API_KEY。 。 。 .

API 密码

interface DeployOptions {
  app: string
  platform?: "local" | "aws" | "gcp" | "azure"
  config?: string
  environmentVariables?: EnvironmentVariable[]
  verbose?: boolean
}

回来的 Deployment 支持:

  • deployment.url
  • deployment.invokeCommand(name, params, { target? }) - 可选 target 以 id 键向特定资源的路径
  • deployment.setExternalSecret(vault, key, value)
  • deployment.upgrade(options) 用于云模式
  • deployment.destroy()

配置

变量说明默认
ALIEN_API_KEY云模式的 API 平台密钥—— 说
ALIEN_API_URL平台 API 基础 URLhttps://api.alien.dev
ALIEN_CLI_PATH路径 alien 二进制自动检测
VERBOSE显示详细的子进程日志false

页:1

  • 本地模式仅需要 alien 二进制
  • 云模式需求 ALIEN_API_KEY
  • repo- 内部低级测试仍然可以直接使用独立的管理器帮助; 这个包是更高级的产品显示层

版本与发布记录

@alienplatform/testing 共发布 100 个版本,首次发布于 2026/03/14;过去 12 个月发布了 100 个版本。

版本发布日期距今
3.3.54latest2026/11/051 天前
3.3.532026/11/042 天前
3.3.522026/11/042 天前
3.3.512026/11/042 天前
3.3.502026/11/033 天前
3.3.492026/11/024 天前

其他发布通道:dev → 3.3.42-dev.6e3a661b219b3886d55014b3cef8af0ecdcc65fe。

关于 @alienplatform/testing 的常见问题

@alienplatform/testing 是什么?

异形应用程序测试框架

如何安装 @alienplatform/testing?

在项目目录运行 npm install @alienplatform/testing,或使用 pnpm add / yarn add / bun add。

@alienplatform/testing 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@alienplatform/testing 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@alienplatform/testing 可以商用吗?

@alienplatform/testing 使用 FSL-1.1-Apache-2.0 许可。声明的许可为 FSL-1.1-Apache-2.0,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

@alienplatform/testing 的下载量有多少?

根据 npm 官方下载统计,@alienplatform/testing 在 2026/10/06 – 2026/11/04 这 30 天内被下载 3,799 次,日均约 127 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@alienplatform/testing 还在维护吗?

最新版本 3.3.54 发布于 2026/11/05(1 天前);至今共发布 100 个版本,其中过去 12 个月发布了 100 个;首次发布于 2026/03/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。