如何在Playwright Fixture中替换any类型为合适类型

问题背景 #

需要将Playwright的discountsTest fixture中discountOpts的any类型替换为更精确的类型，要求该类型支持键为string、值为string/number或两者组合的结构。尝试用Record<string, unknown>替换后出现Fixture签名不匹配的类型错误。

错误原因 #

1. Fixture函数签名不完整：Playwright的TestFixture函数要求第三个参数为可选的TestInfo，原代码中discountOpts的fixture函数只定义了两个参数，导致类型校验失败。
2. 类型匹配精度问题：Record<string, unknown>过于宽泛，若createDiscount函数有明确的参数类型，未对齐会导致潜在类型问题。

解决方案 #

步骤1：定义精准类型 #

根据需求，定义键为string、值为string | number的类型：

type DiscountOpts = Record<string, string | number>;

如果api.createDiscount有现成的参数类型（比如CreateDiscountParams），直接复用该类型会更准确：

// 假设api模块导出了CreateDiscountParams类型
import { CreateDiscountParams } from './path-to-api-module';
type DiscountOpts = CreateDiscountParams;

步骤2：修正Fixture函数签名 #

为discountOpts的fixture函数添加可选的TestInfo参数，匹配Playwright的类型要求：

完整修正代码 #

import { TestInfo } from '@playwright/test';

// 定义目标类型
type DiscountOpts = Record<string, string | number>;

export const discountsTest = baseTest.extend<{
  discount: Serializable;
  discountOpts: DiscountOpts;
}>({
  discount: [
    async ({ discountOpts }, use) => {
      const discountApi = new api(adminToken);
      const discount = await discountApi.createDiscount(discountOpts);
      expect(discount._status).toBe("OK");
      await use(discount);
    },
    { auto: true },
  ],
  discountOpts: [
    // 添加可选的TestInfo参数，满足类型签名要求
    async ({ a }, use, testInfo?: TestInfo) => {
      await use(a);
    },
  ],
});

关键说明 #

• 必须保证fixture函数的签名与Playwright的TestFixture类型一致，即使不需要testInfo参数，也要保留参数位置（标记为可选）。
• 优先复用业务代码中已有的类型（比如createDiscount的参数类型），避免重复定义，提升类型一致性。

内容的提问来源于stack exchange，提问作者mano ranjitha