@wordpress/e2e-test-utils
Advanced tools
End-To-End (E2E) test utils for WordPress.
Install the module
npm install @wordpress/e2e-test-utils --save-dev
Activates an installed plugin.
Parameters
string: Plugin slug.Verifies if publish checks are enabled.
Returns
boolean Boolean which represents the state of prepublish checks.
Clears the local storage.
Clicks the default block appender.
Clicks a button based on the text on the button.
Parameters
string: The text that appears on the button to click.Click on the close button of an open modal.
Parameters
?string: Class name for the modal to closeClicks on More Menu item, searches for the button with the text provided and clicks it.
Parameters
string: The label to search the button for.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.
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.
Creates new post.
Parameters
Object: Object to create new post, along with tips enabling option.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.
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.
Deactivates an active plugin.
Parameters
string: Plugin slug.Disables Pre-publish checks.
Enables even listener which accepts a page dialog which may appear when navigating away from Gutenberg.
Enables Pre-publish checks.
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.
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.
Finds the button responsible for toggling the sidebar panel with the provided title.
Parameters
string: The name of sidebar panel.Returns
?ElementHandle Object that represents an in-page DOM element.
Returns an array with all blocks; Equivalent to calling wp.data.select( 'core/editor' ).getBlocks();
Returns
Promise Promise resolving with an array containing all blocks in the document.
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
Returns a promise which resolves with the edited post content (HTML string).
Returns
Promise Promise resolving with post content markup.
Returns a boolean indicating if the current selected block has a block switcher or not.
Returns
Promise Promise resolving with a boolean.
Opens the inserter, searches for the given term, then selects the first result that appears.
Parameters
string: The text to search the inserter for.string: The inserter panel to open (if it's closed by default).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.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.
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.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.
Binds to the document on page load which throws an error if a focusout
event occurs without a related target (i.e. focus loss).
Clicks on the button in the header which opens Document Settings sidebar when it is closed.
Opens the publish panel.
Presses the given keyboard key a number of times in sequence.
Parameters
string: Key to press.number: Number of times to press.Returns
Promise Promise resolving when key presses complete.
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.Publishes the post, resolving once the request is complete (once a notice is displayed).
Returns
Promise Promise resolving when publish is complete.
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.
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.
Search for block in the global inserter
Parameters
string: The text to search the inserter for.Given the clientId of a block, selects the block on the editor.
Parameters
string: Identified of the block.Sets browser viewport to specified type.
Parameters
string: String to represent dimensions type; can be either small or large.Sets code editor content
Parameters
string: New code editor content.Returns
Promise Promise resolving with an array containing all blocks in the document.
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.Switches editor mode.
Parameters
string: String editor mode.Switches the current user to the admin user (if the user running the test is not already the admin user).
Switches the current user to whichever user we should be running the tests as (if we're not already that user).
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.Converts editor's block type.
Parameters
string: Block name.Uninstalls a plugin.
Parameters
string: Plugin slug.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.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.height: 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.