/** * External dependencies */ import { Coupon, HTTPClientFactory } from '@woocommerce/api'; import config from 'config'; import { activateTheme, disableSiteEditorWelcomeGuide, openGlobalBlockInserter, switchUserToAdmin, visitAdminPage, pressKeyWithModifier, searchForBlock as searchForFSEBlock, } from '@wordpress/e2e-test-utils'; import { addQueryArgs } from '@wordpress/url'; import { WP_ADMIN_DASHBOARD } from '@woocommerce/e2e-utils'; import fs from 'fs'; /** * Internal dependencies */ import { elementExists, getElementData, getTextContent } from './page-utils'; import { PERFORMANCE_REPORT_FILENAME } from '../utils/constants'; /** * @typedef {import('@types/puppeteer').ElementHandle} ElementHandle * @typedef {import('@wordpress/blocks').Block} WPBlock */ /** * @typedef {{ addedBy: string, hasActions: boolean, templateTitle: string }} TemplateTableItem */ export const BASE_URL = config.get( 'url' ); export const adminUsername = config.get( 'users.admin.username' ); export const adminPassword = config.get( 'users.admin.password' ); export const client = HTTPClientFactory.build( BASE_URL ) .withBasicAuth( adminUsername, adminPassword ) .create(); export const GUTENBERG_EDITOR_CONTEXT = process.env.GUTENBERG_EDITOR_CONTEXT || 'core'; export const DEFAULT_TIMEOUT = 30000; const SELECTORS = { canvas: 'iframe[name="editor-canvas"]', inserter: { search: '.components-search-control__input,.block-editor-inserter__search input,.block-editor-inserter__search-input,input.block-editor-inserter__search', }, templatesListTable: { actionsContainer: '.edit-site-list-table__actions', cells: '.edit-site-list-table-column', headings: 'thead th.edit-site-list-table-column', root: '.edit-site-list-table', rows: '.edit-site-list-table-row', templateActions: '.edit-site-list-table button[aria-label="Actions"]', templateTitle: '[data-wp-component="Heading"]', }, themesPage: { currentTheme: '.theme.active', }, toolbar: { confirmSave: '.editor-entities-saved-states__save-button', saveButton: '.edit-site-save-button__button', savePrompt: '.entities-saved-states__text-prompt', }, }; /** * Search for block in the global inserter. * * @see https://github.com/WordPress/gutenberg/blob/2356b2d3165acd0af980d52bc93fb1e42748bb25/packages/e2e-test-utils/src/inserter.js#L95 * * @param {string} searchTerm The text to search the inserter for. */ export async function searchForBlock( searchTerm ) { await page.waitForSelector( SELECTORS.inserter.search ); await page.focus( SELECTORS.inserter.search ); await pressKeyWithModifier( 'primary', 'a' ); await page.keyboard.type( searchTerm ); } /** * Opens the inserter, searches for the given term, then selects the first * result that appears. * * @param {string} searchTerm The text to search the inserter for. */ export async function insertBlockDontWaitForInsertClose( searchTerm ) { await openGlobalBlockInserter(); await searchForBlock( searchTerm ); const insertButton = ( await page.$x( `//button//span[text()='${ searchTerm }']` ) )[ 0 ]; await insertButton.click(); } export const closeInserter = async () => { if ( await page.evaluate( () => { return !! document.querySelector( '.edit-post-header [aria-label="Add block"]' ); } ) ) { await page.click( '.edit-post-header [aria-label="Add block"]' ); return; } await page.click( '.edit-post-header [aria-label="Toggle block inserter"]' ); }; const WP_ADMIN_WIDGETS_EDITOR = WP_ADMIN_DASHBOARD + 'widgets.php'; export const openWidgetEditor = async () => { await page.goto( WP_ADMIN_WIDGETS_EDITOR, { waitUntil: 'networkidle0', } ); }; export const closeModalIfExists = async () => { if ( await page.evaluate( () => { return !! document.querySelector( '.components-modal__header' ); } ) ) { await page.click( '.components-modal__header [aria-label="Close dialog"]' ); } }; export const openWidgetsEditorBlockInserter = async () => { await page.click( '.edit-widgets-header [aria-label="Add block"],.edit-widgets-header [aria-label="Toggle block inserter"]' ); }; export const isBlockInsertedInWidgetsArea = async ( blockName ) => { const widgetAreaSelector = '.wp-block-widget-area'; const widgetsArea = await page.$$( widgetAreaSelector ); return widgetsArea.some( async ( widgetArea ) => ( await widgetArea.$$( `[data-block-title="${ blockName }"]` ) .length ) > 0 ); }; /** * Visits site editor dependening on used WordPress version and how Gutenberg is installed. * * 1. `themes.php?page=gutenberg-edit-site` this is a legacy editor access used for WP <=5.8. * 2. `site-editor.php` is the new way of accessing the editor in WP >=5.9+. * * @param {'core' | 'gutenberg'} [editorContext='core'] Whether to go to the Gutenberg URL or the Core one. * @param {Object} params Query parameters to add to the URL. * @param {string} [params.postId] ID of the template if we want to access template editor. * @param {'wp_template' | 'wp_template_part'} [params.postType='wp_template'] Type of template. */ export async function goToSiteEditor( editorContext = 'core', params ) { // There is a bug in Gutenberg/WPCore now that makes it impossible to rely on site-editor.php on setups // with locally installed Gutenberg. Details in https://github.com/WordPress/gutenberg/issues/39639. // TODO: Update to always use site-editor.php once WordPress 6.0 is released and fix is verified. // Remove usage of goToSiteEditor and GUTENBERG_EDITOR_CONTEXT from from here and from workflows. let editorPath; const queryParams = { ...params }; if ( editorContext === 'gutenberg' ) { editorPath = 'themes.php'; queryParams.page = 'gutenberg-edit-site'; } else { editorPath = 'site-editor.php'; } return await visitAdminPage( editorPath, addQueryArgs( '', queryParams ) ); } /** * Visits the Site Editor template edit view. * * @param {Object} params * @param {string} params.postId ID of the template if we want to access template editor. * @param {'core' | 'gutenberg'} [params.editorContext='core'] Whether to go to the Gutenberg URL or the Core one. * @param {'wp_template' | 'wp_template_part'} [params.postType='wp_template'] Type of template. */ export async function goToTemplateEditor( { postId, postType = 'wp_template', editorContext = GUTENBERG_EDITOR_CONTEXT, } = {} ) { await goToSiteEditor( editorContext, { postType, postId, } ); await disableSiteEditorWelcomeGuide(); await waitForCanvas(); } /** * Visits the Site Editor templates list view. * * @param {Object} params * @param {'core' | 'gutenberg'} [params.editorContext='core'] Whether to go to the Gutenberg URL or the Core one. * @param {'wp_template' | 'wp_template_part'} [params.postType='wp_template'] Type of template. * @param {'list' | 'actions'} [params.waitFor='false'] Wait for list or for actions to be present - tempalte actions can take a moment to load, we can wait for them to be present if needed. */ export async function goToTemplatesList( { postType = 'wp_template', editorContext = GUTENBERG_EDITOR_CONTEXT, waitFor = 'list', } = {} ) { await goToSiteEditor( editorContext, { postType } ); if ( waitFor === 'actions' ) { await page.waitForSelector( SELECTORS.templatesListTable.templateActions ); } else { await page.waitForSelector( SELECTORS.templatesListTable.root ); } } /** * Waits for the Gutenberg canvas to be available * * @param {number} [timeout=DEFAULT_TIMEOUT] The amount of ms to wait for the element * * @return {Promise} The canvas element handle */ export function waitForCanvas( timeout = DEFAULT_TIMEOUT ) { return page.waitForSelector( SELECTORS.canvas, { timeout } ); } /** * Saves a template */ export async function saveTemplate() { const { confirmSave, saveButton, savePrompt } = SELECTORS.toolbar; await page.click( saveButton ); await page.waitForSelector( savePrompt ); await page.click( confirmSave ); await page.waitForSelector( `${ saveButton }[aria-disabled="true"]` ); await page.waitForResponse( ( res ) => { // Will match both templates and template_parts endpoints. return res.url().includes( '/wp/v2/template' ); } ); } /** * Gets all available templates from the template list table UI * * @return {Promise} A promise of an array of informations about the templates extracted from the UI */ export async function getAllTemplates() { const { templatesListTable } = SELECTORS; const table = await page.waitForSelector( templatesListTable.root ); if ( ! table ) throw new Error( 'Templates table not found' ); const rows = await table.$$( templatesListTable.rows ); return Promise.all( rows.map( async ( row ) => ( { addedBy: ( await getTextContent( templatesListTable.cells, row ) )[ 1 ], hasActions: await elementExists( templatesListTable.actionsContainer, row ), templateTitle: ( await getTextContent( templatesListTable.templateTitle, row ) )[ 0 ], } ) ) ); } /** * Gets all the blocks that fulfill a given predicate * * @param {( block: WPBlock ) => boolean} predicate The function invoked per iteration * @return {Promise< Partial< WPBlock >[] >} The blocks which have been found */ export async function filterCurrentBlocks( predicate ) { /** * @type {WPBlock[]} */ const blocks = await page.evaluate( () => { /** * Gets all serializeable data from a block * * @param {WPBlock} block A Gutenberg Block * @return {Partial} A block with unserializeable values turned to `null` */ function getSerializeableBlockData( block ) { return JSON.parse( JSON.stringify( block ) ); } const blockEditorStore = window.wp.data.select( 'core/block-editor' ); /** * @type {string[]} */ const allClientIds = blockEditorStore.getClientIdsWithDescendants(); return allClientIds.map( ( id ) => getSerializeableBlockData( blockEditorStore.getBlock( id ) ) ); } ); return blocks.filter( predicate ); } /** * Sets up a suite to use a theme without side-effects * * *Note:* this “hook” is supposed to be used within `describe` calls to * make it easier to set theme dependencies for tests without messing * the environment of any other test and to explicitly declare a * dependency. * * @param {string} themeSlug The theme the test suite should use */ export function useTheme( themeSlug ) { let previousTheme; beforeAll( async () => { await switchUserToAdmin(); await visitAdminPage( 'themes.php' ); previousTheme = await getElementData( SELECTORS.themesPage.currentTheme, 'slug' ); await activateTheme( themeSlug ); } ); afterAll( async () => { await activateTheme( previousTheme ); } ); } /** * Takes an average value of all items in an array. * * @param {Array} array An array of numbers to take an average from. * @return {number} The average value of all members of the array. */ const average = ( array ) => array.reduce( ( a, b ) => a + b ) / array.length; /** * Writes a line to the e2e performance result for the current test containing longest, shortest, and average run times. * * @param {string} description Message to describe what you're logging the performance of. * @param {Array} times array of times to record. */ export const logPerformanceResult = ( description, times ) => { const roundedTimes = times.map( ( time ) => Math.round( time + Number.EPSILON * 100 ) / 100 ); fs.appendFileSync( PERFORMANCE_REPORT_FILENAME, JSON.stringify( { description, longest: Math.max( ...roundedTimes ), shortest: Math.min( ...roundedTimes ), average: average( roundedTimes ), } ) + '\n' ); }; /* Add a block to Full Site Editing. * * *Note:* insertBlock function gets focused on the canvas, this could prevent some dialogs from being displayed. e.g. compatibility notice. * * @param {string} blockName Block name. */ export const addBlockToFSEArea = async ( blockName ) => { await searchForFSEBlock( blockName ); const insertButton = await page.waitForXPath( `//button//span[contains(text(), '${ blockName }')]` ); await insertButton.click(); }; /** * Creates a basic coupon with the provided coupon amount. Returns the coupon code. * * @param {Object} [coupon] Coupon object. Default to fixed cart type and amount = 5. * @param {string} [coupon.amount] Amount to be applied. Defaults to 5. * @param {string} [coupon.discountType] Type of a coupon. Defaults to Fixed cart discount. * @param {number} [coupon.usageLimit] How many times the coupon can be used in total. Defaults to -1. */ export const createCoupon = async ( coupon ) => { const { amount = '5', discountType = 'Fixed cart discount', usageLimit = -1, } = coupon || { amount: '5', discountType: 'Fixed cart discount' }; let couponType; switch ( discountType ) { case 'Fixed cart discount': couponType = 'fixed_cart'; break; case 'Fixed product discount': couponType = 'fixed_product'; break; case 'Percentage discount': couponType = 'percent'; break; default: couponType = discountType; } // Fill in coupon code const couponCode = 'code-' + couponType + new Date().getTime().toString(); const repository = Coupon.restRepository( client ); const createdCoupon = await repository.create( { code: couponCode, discountType: couponType, amount, usageLimit, } ); return createdCoupon; }; /** * Open the block editor settings menu. */ export const openBlockEditorSettings = async () => { const buttonSelector = '.edit-site-header__actions button[aria-label="Settings"]'; const isSideBarAlreadyOpened = await page.$( '.interface-interface-skeleton__sidebar' ); if ( isSideBarAlreadyOpened === null ) { await page.click( buttonSelector ); } }; /** * Click a link and wait for the page to load. * * @param {string} selector The CSS selector of the link to click. */ export const clickLink = async ( selector ) => { await Promise.all( [ page.click( selector ), page.waitForNavigation( { waitUntil: 'networkidle0' } ), ] ); };