Playdrums is a WIP free and open source Node.js library with a clear and concise API mainly inspired by Taiko written by the team behind Gauge from ThoughtWorks.
It interracts with Playwright, the new multiBrowser framework by the former puppeteer team now at Microsoft.
It tries to combine best of both world:
- High readability of tests
- Automate the Chromium, WebKit and Firefox browsers with a single API. (with headless support for all)
- Enable cross-browser web automation that is ever-green, capable, reliable and fast.
- Headless is supported for all the browsers on all platforms.
- Allows mobile emulation with webkit based browser (to simulate iDevices)
See API
npm install playdrums
XHR Requests can be:
- Blocked
- Redirected
- Modified before sending
- Stubbed
See Details
Every action that could invoke a navigation:
can easily wait for:
- Specific event raised
- Request to be sent
- Response of request to be received
- Navigation
before executing next Step
✅ Context and page are now clearly indentified.
✅ Intercept are now clearly set to a context which can of course handle several pages(tabs in taiko) and better for parallelized tests.
✅ Switch tab between concept is allowed.
✅ All interracation are made through xpath,csspath or text using $ function (See details)
✅ All playwright options have been kept.
❌ Proximity Selectors and element selectors have been removed.
❌ cli have also been removed.
❌ still some work in progress... ⌛
const { openBrowser,write, closeBrowser, goto, press, screenshot, focus, $, waitFor } = require('playdrums');
describe('Getting Started with Jest and Playdrums', () => {
beforeAll(async () => {
await openBrowser({ headless: false, url:'about:blank' });
});
describe('Search Playdrums Repository', () => {
test('Goto github page', async () => {
await goto('https://github.com');
});
test('Search for playdrums', async () => {
await focus($('[name=q]'))
await write('playdrums');
await press('Enter');
});
test('Page contains playdrums', async () => {
await waitFor($('//*[@href="/sarut0bi/playDrums"]'))
});
});
afterAll(async () => {
await closeBrowser();
});
});"use strict";
const {openBrowser,write, closeBrowser, goto, press, screenshot, focus, $, waitFor} = require('playdrums');
const assert = require("assert");
const headless = false;
describe('Getting Started with Mocha and Playdrums', () => {
before(async () => {
await openBrowser({ headless: headless });
});
describe('Search Playdrums Repository', () => {
it('Goto github page', async () => {
await goto('https://github.com');
});
it('Search for playdrums', async () => {
await focus($('[name=q]'))
await write('playdrums');
await press('Enter');
});
it('Page contains playdrums', async () => {
await waitFor($('//*[@href="/sarut0bi/playDrums"]'));
});
});
after(async () => {
await closeBrowser();
});
});/* globals gauge*/
"use strict";
const { openBrowser,write, closeBrowser, goto, press, screenshot, focus, $, waitFor } = require('playdrums');
const assert = require("assert");
beforeSuite(async () => {
await openBrowser({ headless: false })
});
afterSuite(async () => {
await closeBrowser();
});
gauge.screenshotFn = async function() {
return await screenshot({ encoding: 'base64' });
};
step("Goto github page", async () => {
await goto('https://github.com');
});
step("Search for playdrums", async () => {
await focus($('[name=q]'))
await write('playdrums');
await press('Enter');
});
step("Page contains playdrums", async () => {
assert.ok(await waitFor($('//*[@href="/sarut0bi/playDrums"]')));
});