解决 Playwright 中 ‘test’ 未定义引用错误

本文旨在解决 Playwright 自动化测试中常见的 `ReferenceError: test is not defined` 错误。该错误通常是由于在 JavaScript 测试文件中未能正确导入 Playwright 测试框架提供的 `test` 函数所致。通过本文，您将了解如何正确导入 `test` 和 `expect` 函数，从而顺利定义和执行您的 Playwright 测试用例。

Playwright 测试中 'test is not defined' 错误的解析与修正

在使用 Playwright 编写自动化测试时，开发者可能会遇到一个常见的 ReferenceError: test is not defined 错误。这个错误通常发生在尝试定义测试块时，例如使用 test('My Test Case', async ({ page }) => { ... }); 结构。

错误现象分析

当您执行类似以下代码的 Playwright 测试文件时：

import { expect } from '@playwright/test'; // 注意：此处缺少 'test' 导入

test('Home Page', async ({page}) => {
    await page.goto('https://www.myntra.com/');
    const pageTitle= await page.title();
    console.log('Page titleis:', pageTitle);
    await expect(page).toHaveTitle('Online Shopping for Women, Men, Kids Fashion & Lifestyle - Myntra');
    const pageURL=page.url();
    console.log('Page URL is:',pageURL);
    // 修正：expect.page.toHaveURL 应为 expect(page).toHaveURL
    await expect(page).toHaveURL('https://www.myntra.com/')
    // Playwright 自动管理 page.close()，通常不需要手动调用
    // await page.close();
})

运行上述代码会导致 ReferenceError: test is not defined 错误。这是因为尽管您导入了 expect 断言库，但用于定义测试块的核心 test 函数却未被导入。

错误根源：模块导入缺失

Playwright 的测试运行器 (@playwright/test) 提供了一系列全局可用的函数和对象，例如 test 用于定义测试用例，以及 expect 用于进行断言。这些功能并非全局自动注入到您的脚本中，而是需要通过 ES Module 导入机制显式地引入。当您在文件中使用 test() 函数来定义一个测试块时，JavaScript 引擎会查找名为 test 的变量或函数。如果它没有被导入或定义，就会抛出引用错误。

百度文心百中

百度大模型语义搜索体验中心

22

查看详情

解决方案：正确导入 test 函数

解决这个问题的关键在于确保从 @playwright/test 模块中同时导入 test 和 expect。正确的导入语句应该如下所示：

import { test, expect } from '@playwright/test';

通过添加 test 到导入列表中，您就将 Playwright 提供的 test 函数引入到当前文件的作用域内，使其可以被正确识别和调用。

完整修正后的示例代码

将上述导入语句应用于您的测试文件后，完整的代码将如下所示：

import { test, expect } from '@playwright/test'; // 正确导入 'test' 和 'expect'

test('Myntra 首页验证', async ({ page }) => {
    // 导航到指定URL
    await page.goto('https://www.myntra.com/');

    // 获取页面标题并打印
    const pageTitle = await page.title();
    console.log('页面标题:', pageTitle);

    // 断言页面标题是否符合预期
    await expect(page).toHaveTitle('Online Shopping for Women, Men, Kids Fashion & Lifestyle - Myntra');

    // 获取页面URL并打印
    const pageURL = page.url();
    console.log('页面URL:', pageURL);

    // 断言页面URL是否符合预期
    await expect(page).toHaveURL('https://www.myntra.com/');

    // 注意：在 Playwright 的测试框架中，通常不需要手动关闭页面。
    // page 对象会在测试完成后由框架自动清理。
    // await page.close();
});

注意事项与最佳实践

1. 统一导入： 养成从 @playwright/test 统一导入 test 和 expect 的习惯。这不仅解决了当前问题，也保持了代码的一致性。
2. 自动清理： Playwright 的测试框架会智能地管理 page 和 browser 实例的生命周期。在大多数情况下，您不需要在测试结束时手动调用 page.close() 或 browser.close()，框架会自动处理这些资源的释放。
3. 断言语法： 确保 expect 断言的语法正确。例如，expect.page.toHaveURL 是错误的，正确的写法是 expect(page).toHaveURL。expect 函数接收一个值作为参数，然后链式调用匹配器（如 toHaveURL）。
4. 模块化： 对于大型项目，可以将常用的辅助函数、页面对象模型 (POM) 等进行模块化，并在测试文件中按需导入，保持测试代码的整洁和可维护性。

总结

ReferenceError: test is not defined 错误是 Playwright 初学者常遇到的问题，其根本原因在于未能从 @playwright/test 模块中正确导入 test 函数。通过简单地修改导入语句为 import { test, expect } from '@playwright/test'; 即可解决此问题。理解 Playwright 的模块导入机制是编写健壮、可维护自动化测试代码的基础。遵循正确的导入规范和最佳实践，将有助于您更高效地利用 Playwright 进行 Web 自动化测试。

以上就是解决 Playwright 中 ‘test’ 未定义引用错误的详细内容，更多请关注php中文网其它相关文章！