@wordpress/e2e-test-utils
Advanced tools
End-To-End (E2E) test utils for WordPress.
It works properly with the minimum version of Gutenberg 5.6.0 or the minimum version of WordPress 5.2.0.
Install the module
npm install @wordpress/e2e-test-utils --save-dev
# activatePlugin
Activates an installed plugin.
Parameters
string: Plugin slug.# arePrePublishChecksEnabled
Verifies if publish checks are enabled.
Returns
Promise<boolean>: Boolean which represents the state of prepublish checks.# clearLocalStorage
Clears the local storage.
# clickBlockAppender
Clicks the default block appender.
# clickBlockToolbarButton
Clicks a block toolbar button.
Parameters
string: The aria label of the button to click.# clickButton
Clicks a button based on the text on the button.
Parameters
string: The text that appears on the button to click.# clickOnCloseModalButton
Click on the close button of an open modal.
Parameters
?string: Class name for the modal to close# clickOnMoreMenuItem
Clicks on More Menu item, searches for the button with the text provided and clicks it.
Parameters
string: The label to search the button for.# closeGlobalBlockInserter
Undocumented declaration.
# createEmbeddingMatcher
Creates a function to determine if a request is embedding a certain URL.
Parameters
string: The URL to check against a request.Returns
Function: Function that determines if a request is for the embed API, embedding a specific URL.# createJSONResponse
Respond to a request with a JSON response.
Parameters
string: The mock object to wrap in a JSON response.Returns
Promise: Promise that responds to a request with the mock JSON response.# createNewPost
Creates new post.
Parameters
Object: Object to create new post, along with tips enabling option.[string]: Post type of the new post.[string]: Title of the new post.[string]: Content of the new post.[string]: Excerpt of the new post.[boolean]: Whether to show the welcome guide.# createURL
Creates new URL by parsing base URL, WPPath and query string.
Parameters
string: String to be serialized as pathname.?string: String to be serialized as query portion of URL.Returns
string: String which represents full URL.# createURLMatcher
Creates a function to determine if a request is calling a URL with the substring present.
Parameters
string: The substring to check for.Returns
Function: Function that determines if a request's URL contains substring.# deactivatePlugin
Deactivates an active plugin.
Parameters
string: Plugin slug.# disableFocusLossObservation
Removes the focus loss listener that enableFocusLossObservation() adds.
# disablePrePublishChecks
Disables Pre-publish checks.
# dragAndResize
Clicks an element, drags a particular distance and releases the mouse button.
Parameters
Object: The puppeteer element handle.Object: Object containing movement distances.number: Horizontal distance to drag.number: Vertical distance to drag.Returns
Promise: Promise resolving when drag completes.# enableFocusLossObservation
Adds an event listener to the document which throws an error if there is a loss of focus.
# enablePageDialogAccept
Enables even listener which accepts a page dialog which may appear when navigating away from Gutenberg.
# enablePrePublishChecks
Enables Pre-publish checks.
# ensureSidebarOpened
Verifies that the edit post sidebar is opened, and if it is not, opens it.
Returns
Promise: Promise resolving once the edit post sidebar is opened.# findSidebarPanelToggleButtonWithTitle
Finds a sidebar panel with the provided title.
Parameters
string: The name of sidebar panel.Returns
?ElementHandle: Object that represents an in-page DOM element.# findSidebarPanelWithTitle
Finds the button responsible for toggling the sidebar panel with the provided title.
Parameters
string: The name of sidebar panel.Returns
Promise<(ElementHandle|undefined)>: Object that represents an in-page DOM element.# getAllBlockInserterItemTitles
Returns an array of strings with all inserter item titles.
Returns
Promise: Promise resolving with an array containing all inserter item titles.# getAllBlocks
Returns an array with all blocks; Equivalent to calling wp.data.select( 'core/block-editor' ).getBlocks();
Returns
Promise: Promise resolving with an array containing all blocks in the document.# getAvailableBlockTransforms
Returns an array of strings with all block titles, that the current selected block can be transformed into.
Returns
Promise: Promise resolving with an array containing all possible block transforms# getBlockSetting
Returns a string containing the block title associated with the provided block name.
Parameters
string: Block name.string: Block setting e.g: title, attributes....Returns
Promise: Promise resolving with a string containing the block title.# getCurrentPostContent
Returns a promise which resolves with the current post content (HTML string).
Returns
Promise: Promise resolving with current post content markup.# getEditedPostContent
Returns a promise which resolves with the edited post content (HTML string).
Returns
Promise: Promise resolving with post content markup.# getPageError
Returns a promise resolving to one of either a string or null. A string will be resolved if an error message is present in the contents of the page. If no error is present, a null value will be resolved instead. This requires the environment be configured to display errors.
Related
Returns
Promise<?string>: Promise resolving to a string or null, depending whether a page error is present.# hasBlockSwitcher
Returns a boolean indicating if the current selected block has a block switcher or not.
Returns
Promise: Promise resolving with a boolean.# insertBlock
Opens the inserter, searches for the given term, then selects the first result that appears. It then waits briefly for the block list to update.
Parameters
string: The text to search the inserter for.# insertPattern
Opens the inserter, searches for the given pattern, then selects the first result that appears. It then waits briefly for the block list to update.
Parameters
string: The text to search the inserter for.# insertReusableBlock
Opens the inserter, searches for the given reusable block, then selects the first result that appears. It then waits briefly for the block list to update.
Parameters
string: The text to search the inserter for.# installPlugin
Installs a plugin from the WP.org repository.
Parameters
string: Plugin slug.?string: If the plugin is not findable by its slug use an alternative term to search.# isCurrentURL
Checks if current URL is a WordPress path.
Parameters
string: String to be serialized as pathname.?string: String to be serialized as query portion of URL.Returns
boolean: Boolean represents whether current URL is or not a WordPress path.# isInDefaultBlock
Checks if the block that is focused is the default block.
Returns
Promise: Promise resolving with a boolean indicating if the focused block is the default block.# isOfflineMode
Undocumented declaration.
# loginUser
Performs log in with specified username and password.
Parameters
?string: String to be used as user credential.?string: String to be used as user credential.# mockOrTransform
Mocks a request with the supplied mock object, or allows it to run with an optional transform, based on the deserialised JSON response for the request.
Parameters
Function: function that returns true if the request should be mocked.Object: A mock object to wrap in a JSON response, if the request should be mocked.(Function|undefined): An optional function that transforms the response's object before the response is used.Returns
Promise: Promise that uses mockCheck to see if a request should be mocked with mock, and optionally transforms the response with responseObjectTransform.# openDocumentSettingsSidebar
Clicks on the button in the header which opens Document Settings sidebar when it is closed.
# openGlobalBlockInserter
Opens the global block inserter.
# openPublishPanel
Opens the publish panel.
# pressKeyTimes
Presses the given keyboard key a number of times in sequence.
Parameters
string: Key to press.number: Number of times to press.# pressKeyWithModifier
Performs a key press with modifier (Shift, Control, Meta, Alt), where each modifier is normalized to platform-specific modifier.
Parameters
string: Modifier key.string: Key to press while modifier held.# publishPost
Publishes the post, resolving once the request is complete (once a notice is displayed).
Returns
Promise: Promise resolving when publish is complete.# publishPostWithPrePublishChecksDisabled
Publishes the post without the pre-publish checks, resolving once the request is complete (once a notice is displayed).
Returns
Promise: Promise resolving when publish is complete.# saveDraft
Saves the post as a draft, resolving once the request is complete (once the "Saved" indicator is displayed).
Returns
Promise: Promise resolving when draft save is complete.# searchForBlock
Search for block in the global inserter
Parameters
string: The text to search the inserter for.# searchForPattern
Search for pattern in the global inserter
Parameters
string: The text to search the inserter for.# searchForReusableBlock
Search for reusable block in the global inserter.
Parameters
string: The text to search the inserter for.# selectBlockByClientId
Given the clientId of a block, selects the block on the editor.
Parameters
string: Identified of the block.# setBrowserViewport
Sets browser viewport to specified type.
Parameters
WPViewport: Viewport name or dimensions object to assign.# setPostContent
Sets code editor content
Parameters
string: New code editor content.Returns
Promise: Promise resolving with an array containing all blocks in the document.# setUpResponseMocking
Sets up mock checks and responses. Accepts a list of mock settings with the following properties:
match: function to check if a request should be mocked.onRequestMatch: async function to respond to the request.Usage
const MOCK_RESPONSES = [
{
match: isEmbedding( 'https://wordpress.org/gutenberg/handbook/' ),
onRequestMatch: JSONResponse( MOCK_BAD_WORDPRESS_RESPONSE ),
},
{
match: isEmbedding( 'https://wordpress.org/gutenberg/handbook/block-api/attributes/' ),
onRequestMatch: JSONResponse( MOCK_EMBED_WORDPRESS_SUCCESS_RESPONSE ),
}
];
setUpResponseMocking( MOCK_RESPONSES );
If none of the mock settings match the request, the request is allowed to continue.
Parameters
Array: Array of mock settings.# showBlockToolbar
The block toolbar is not always visible while typing. Call this function to reveal it.
# switchEditorModeTo
Switches editor mode.
Parameters
string: String editor mode.# switchUserToAdmin
Switches the current user to the admin user (if the user running the test is not already the admin user).
# switchUserToTest
Switches the current user to whichever user we should be running the tests as (if we're not already that user).
# toggleMoreMenu
Toggles the More Menu.
# toggleOfflineMode
Undocumented declaration.
# toggleScreenOption
Toggles the screen option with the given label.
Parameters
string: The label of the screen option, e.g. 'Show Tips'.?boolean: If true, turns the option on. If false, off. If undefined, the option will be toggled.# transformBlockTo
Converts editor's block type.
Parameters
string: Block name.# trashAllPosts
Navigates to the post listing screen and bulk-trashes any posts which exist.
Parameters
string: String slug for type of post to trash.Returns
Promise: Promise resolving once posts have been trashed.# uninstallPlugin
Uninstalls a plugin.
Parameters
string: Plugin slug.# visitAdminPage
Visits admin page; if user is not logged in then it logging in it first, then visits admin page.
Parameters
string: String to be serialized as pathname.string: String to be serialized as query portion of URL.# waitForWindowDimensions
Function that waits until the page viewport has the required dimensions. It is being used to address a problem where after using setViewport the execution may continue, without the new dimensions being applied. https://github.com/GoogleChrome/puppeteer/issues/1751
Parameters
number: Width of the window.number: Height of the window.
FAQs
End-To-End (E2E) test utils for WordPress.
The npm package @wordpress/e2e-test-utils receives a total of 30,781 weekly downloads. As such, @wordpress/e2e-test-utils popularity was classified as popular.
We found that @wordpress/e2e-test-utils demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.