You need to enable JavaScript to run this app. Playwright Test Runner测试失败 需修改脚本语法适配TypeScript吗?
优惠活动
大模型
产品
解决方案
定价
更多

Playwright Test Runner测试失败 需修改脚本语法适配TypeScript吗?

适配Playwright测试运行器+TypeScript的必要调整

TypeScript是JavaScript超集,仅做语法替换不需要调整业务逻辑,但你现在切换的是Playwright官方测试运行器(npx folio是@playwright/test的旧版调用命令),和之前直接用node跑裸脚本的运行逻辑完全不同,除了顶部声明外,必须调整以下主体内容:

  • 测试逻辑必须包裹在test块中

    之前裸脚本直接在顶层写自执行异步函数调用浏览器即可,但测试运行器要求所有执行逻辑必须放在test('用例名', async () => {})的回调中,顶层直接写的执行代码会在运行器初始化阶段就触发执行,直接报错。

  • 替换手动实例化逻辑为内置fixture注入

    之前的JS脚本需要手动调用chromium.launch()、browser.newPage()管理浏览器/页面生命周期,用测试运行器时不需要手动创建这些实例,直接通过回调参数注入内置的page、browser、context等fixture即可,重复手动创建实例会导致端口冲突、资源泄漏直接报错。

  • 适配测试运行器自带的异步断言

    测试运行器自带可重试的异步expect断言,之前如果用普通同步断言判断页面元素、标题等异步内容,会因为逻辑还没执行完成就触发断言导致失败,建议统一替换为官方expect断言。

  • 补充类型标注(仅开启TS严格模式时需要)

    如果你的项目tsconfig.json开启了strict: true等严格校验规则,需要给自定义变量补充对应的类型标注,导入Playwright内置的类型定义即可,比如import type { Page, Browser } from '@playwright/test'。


新旧写法对比示例

旧JS裸脚本写法
const { chromium } = require('playwright');
(async () => {
  const browser = await chromium.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');
  console.log(await page.title() === 'Example Domain');
  await browser.close();
})();
新TS+测试运行器写法
import { test, expect } from '@playwright/test';

test('验证示例站点标题', async ({ page }) => {
  await page.goto('https://example.com');
  await expect(page).toHaveTitle('Example Domain');
});

内容的提问来源于stack exchange,提问作者Sam Davies

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 03:15:04