E2E Test Utils

Experimental End-To-End (E2E) Playwright test utils for WordPress.

This package is still experimental and breaking changes could be introduced in future minor versions (v0.x). Use it at your own risks.

It works properly with the minimum version of Gutenberg 9.2.0 or the minimum version of WordPress 5.6.0.

Installation

Install the module

npm install @wordpress/e2e-test-utils-playwright --save-dev

Note: This package requires Node.js 12.0.0 or later. It is not compatible with older versions.

API

test

The extended Playwright's test module with the admin, pageUtils and the requestUtils fixtures.

expect

The Playwright/Jest's expect function.

Admin

End to end test utilities for WordPress admin's user interface.

const admin = new Admin( { page, pageUtils } );
await admin.visitAdminPage( 'options-general.php' );

Editor

End to end test utilities for the WordPress Block Editor.

To use these utilities, instantiate them within each test file:

test.use( {
	editor: async ( { page }, use ) => {
		await use( new Editor( { page, hasIframe: true } ) );
	},
} );

The hasIframe property denotes whether the editor canvas uses an Iframe, as the site editor currently does. Omit this for non-iframe editors.

Within a test or test utility, use the canvas property to select elements within the iframe canvas:

await editor.canvas.locator( 'role=document[name="Paragraph block"i]' )

PageUtils

Generic Playwright utilities for interacting with web pages.

const pageUtils = new PageUtils( { page } );
await pageUtils.pressKeyWithModifier( 'primary', 'a' );

RequestUtils

Playwright utilities for interacting with the WordPress REST API.

Create a request utils instance.

const requestUtils = await RequestUtils.setup( {
	user: {
		username: 'admin',
		password: 'password',
	},
} );