在Node.js环境下使用Playwright添加自定义实现方式

 更新时间:2025年08月08日 15:24:44   作者:勤奋的码农007  
这篇文章主要介绍了在Node.js环境下使用Playwright添加自定义实现方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教

方法1:直接创建实用工具函数(推荐)

原理:创建独立的工具函数,通过参数传入 page 对象操作页面

// utils/custom-actions.js
module.exports = {
  async login(page, username, password) {
    await page.goto('https://example.com/login');
    await page.fill('#username', username);
    await page.fill('#password', password);
    await page.click('#submit');
    await page.waitForURL(/dashboard/);
  },
  
  async captureScreenshot(page, fileName) {
    await page.screenshot({ path: `screenshots/${fileName}.png` });
  }
};

使用方式

const { test } = require('@playwright/test');
const { login, captureScreenshot } = require('./utils/custom-actions');

test('Authentication test', async ({ page }) => {
  // 使用自定义方法
  await login(page, 'test@email.com', 'p@ssw0rd');
  await captureScreenshot(page, 'dashboard-view');
});

方法2:封装自定义 Page 类(通过组合模式)

原理:创建代理类包裹原始 page 对象,添加额外方法

// lib/custom-page.js
module.exports = class CustomPage {
  constructor(page) {
    this.page = page;
  }

  async typeSlowly(selector, text, delay = 100) {
    for (const char of text) {
      await this.page.type(selector, char);
      await this.page.waitForTimeout(delay);
    }
  }

  async dragAndDrop(sourceSel, targetSel) {
    const source = await this.page.$(sourceSel);
    const target = await this.page.$(targetSel);
    await this.page.dragAndDrop(source, target);
  }
};

使用方式

const { test } = require('@playwright/test');
const CustomPage = require('./lib/custom-page');

test('Form test', async ({ page }) => {
  const customPage = new CustomPage(page);
  
  await customPage.typeSlowly('#comment', 'Hello World', 150);
  await customPage.dragAndDrop('#item1', '#drop-zone');
});

方法3:通过 Test Fixtures 扩展(Playwright 官方推荐)

原理:利用 Playwright 的 fixture 系统扩展测试上下文

// fixtures.js
const base = require('@playwright/test');
const CustomPage = require('./lib/custom-page');

exports.test = base.test.extend({
  customPage: async ({ page }, use) => {
    const customPage = new CustomPage(page);
    await use(customPage);
  }
});

使用方式

// tests.spec.js
const { test } = require('./fixtures');

test('Advanced test', async ({ customPage }) => {
  await customPage.typeSlowly('#bio', 'Automation Engineer');
  // 原始 page 仍然可用
  await customPage.page.keyboard.press('Enter');
});

主要优势

  1. 无侵入性:不修改 Playwright 源码或原型
  2. 按需组合:可以混合使用原生 API 和自定义方法
  3. 维护性强:自定义逻辑集中管理
  4. TypeScript 支持:通过声明文件添加类型提示(如使用 TS)

最佳实践建议

  1. 将常用操作封装成独立功能(如登录、数据生成)
  2. 为复杂交互创建专用工具类(如表格操作、拖放序列)
  3. 在 fixtures 中初始化常用测试状态
  4. 对自定义方法添加错误处理和日志
  5. 使用 page.waitForFunction() 实现高级等待逻辑
// 高级:等待元素包含特定文本
async waitForText(selector, text, timeout = 5000) {
  await this.page.waitForFunction(
    ({ sel, txt }) => {
      const el = document.querySelector(sel);
      return el?.innerText?.includes(txt);
    },
    { selector, text },
    { timeout }
  );
}

这些方法既保持了 Playwright API 的原始完整性,又能有效扩展测试能力,特别适合复杂应用的测试场景。

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • 关于express与koa的使用对比详解

    关于express与koa的使用对比详解

    很多人都在问到底该用Koa还是express,所以下面这篇文章就来给大家再次的对比了关于express与koa的相关资料,通过对比大家可以更好的进行选择,文中通过示例代码介绍的非常详细,需要的朋友可以参考借鉴,下面随着小编来一起学习学习吧。
    2018-01-01
  • nodejs实现套接字服务功能详解

    nodejs实现套接字服务功能详解

    这篇文章主要介绍了nodejs实现套接字服务功能,简单描述了套接字的概念、功能,并结合实例形式分析了nodejs使用socket对象创建及使用套接字进行数据传输相关操作技巧与注意事项,需要的朋友可以参考下
    2018-06-06
  • 如何利用node实现发送QQ邮箱验证码

    如何利用node实现发送QQ邮箱验证码

    我们在开发网站时,发送验证码的功能是必定会遇到的,下面这篇文章主要给大家介绍了关于如何利用node实现发送QQ邮箱验证码的相关资料,文中通过示例代码介绍的非常详细,需要的朋友可以参考下
    2022-04-04
  • Nodejs做文本数据处理实现详解

    Nodejs做文本数据处理实现详解

    这篇文章主要为大家介绍了Nodejs做文本数据处理实现详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-11-11
  • node.js中的url.parse方法使用说明

    node.js中的url.parse方法使用说明

    这篇文章主要介绍了node.js中的url.parse方法使用说明,本文介绍了url.parse的方法说明、语法、接收参数、使用实例和实现源码,需要的朋友可以参考下
    2014-12-12
  • node-gyp安装vuetify编译失败gyp ERR的问题及解决

    node-gyp安装vuetify编译失败gyp ERR的问题及解决

    这篇文章主要介绍了node-gyp安装vuetify编译失败gyp ERR的问题及解决方案,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-03-03
  • Node.js抓取网站中文乱码解决办法

    Node.js抓取网站中文乱码解决办法

    这篇文章主要介绍了Node.js抓取网站中文乱码解决办法,需要的朋友可以参考下
    2023-02-02
  • Mac 安装 nodejs方法(图文详细步骤)

    Mac 安装 nodejs方法(图文详细步骤)

    这篇文章主要介绍了Mac 安装 nodejs方法(图文详细步骤),小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-10-10
  • Node.js 使用request模块下载文件的实例

    Node.js 使用request模块下载文件的实例

    今天小编就为大家分享一篇Node.js 使用request模块下载文件的实例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-09-09
  • Node.js工具库yeoman使用介绍

    Node.js工具库yeoman使用介绍

    这篇文章主要为大家介绍了Node.js工具库yeoman的使用介绍,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2024-01-01

最新评论