202 lines
10 KiB
Markdown
202 lines
10 KiB
Markdown
# WooCommerce End to End Test Utilities
|
|
|
|
This package contains utilities to simplify writing e2e tests specific to WooCommmerce.
|
|
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
npm install @woocommerce/e2e-utils --save
|
|
```
|
|
|
|
## Usage
|
|
|
|
Example:
|
|
~~~js
|
|
import {
|
|
shopper,
|
|
merchant,
|
|
createSimpleProduct
|
|
} from '@woocommerce/e2e-utils';
|
|
|
|
describe( 'Cart page', () => {
|
|
beforeAll( async () => {
|
|
await createSimpleProduct();
|
|
} );
|
|
|
|
it( 'should display no item in the cart', async () => {
|
|
await shopper.goToCart();
|
|
await expect( page ).toMatchElement( '.cart-empty', { text: 'Your cart is currently empty.' } );
|
|
} );
|
|
} );
|
|
~~~
|
|
|
|
### Retries
|
|
|
|
This package provides support for enabling retries in tests:
|
|
|
|
- In the test environment set `E2E_RETEST=1`.
|
|
- To add conditional logic to your tests use the boolean constant `IS_RETEST_MODE`.
|
|
|
|
### Available constants
|
|
|
|
#### Dashboard
|
|
|
|
- `WP_ADMIN_LOGIN` - WordPress login
|
|
- `WP_ADMIN_DASHBOARD` - WordPress dashboard
|
|
- `WP_ADMIN_WP_UPDATES` - WordPress updates
|
|
- `WP_ADMIN_PLUGINS` - Plugin list
|
|
- `WP_ADMIN_PERMALINK_SETTINGS` - Permalink settings
|
|
- `WP_ADMIN_ALL_USERS_VIEW` - WordPress user list
|
|
- `WP_ADMIN_POST_TYPE` - Post listing
|
|
- `WP_ADMIN_NEW_POST_TYPE` - New post
|
|
- `WP_ADMIN_ALL_COUPONS_VIEW` - Coupons list
|
|
- `WP_ADMIN_NEW_COUPON` - New coupon
|
|
- `WP_ADMIN_ALL_ORDERS_VIEW` - Orders list
|
|
- `WP_ADMIN_NEW_ORDER` - New Order
|
|
- `WP_ADMIN_ALL_PRODUCTS_VIEW` - Products list
|
|
- `WP_ADMIN_NEW_PRODUCT` - New product
|
|
- `WP_ADMIN_IMPORT_PRODUCTS` - Import products
|
|
- `WP_ADMIN_PLUGIN_PAGE` - Plugin settings page root
|
|
- `WP_ADMIN_WC_HOME` - WooCommerce home screen
|
|
- `WP_ADMIN_SETUP_WIZARD` - WooCommerce setup/onboarding wizard
|
|
- `WP_ADMIN_ANALYTICS_PAGES` - WooCommerce analytics page root
|
|
- `WP_ADMIN_WC_SETTINGS` - WooCommerce settings page root
|
|
- `WP_ADMIN_NEW_SHIPPING_ZONE` - WooCommerce new shipping zone
|
|
- `WP_ADMIN_WC_EXTENSIONS` - WooCommerce extensions page
|
|
- `WP_ADMIN_PLUGIN_INSTALL` - WordPress plugin install page
|
|
|
|
#### Front end
|
|
|
|
- `SHOP_PAGE` - Shop page
|
|
- `SHOP_PRODUCT_PAGE` - Single product page
|
|
- `SHOP_CART_PAGE` - Cart page
|
|
- `SHOP_CHECKOUT_PAGE` - Checkout page
|
|
- `SHOP_MY_ACCOUNT_PAGE` - Customer account page
|
|
- `MY_ACCOUNT_ORDERS` - Customer orders
|
|
- `MY_ACCOUNT_DOWNLOADS` - Customer downloads
|
|
- `MY_ACCOUNT_ADDRESSES` - Customer addresses
|
|
- `MY_ACCOUNT_ACCOUNT_DETAILS` - Customer account details
|
|
|
|
## Test Function
|
|
|
|
### Merchant `merchant`
|
|
|
|
| Function | Parameters | Description |
|
|
|----------|-------------|------------|
|
|
| `goToOrder` | `orderId` | Go to view a single order |
|
|
| `goToProduct` | `productId` | Go to view a single product |
|
|
| `login` | | Log in as merchant |
|
|
| `logout` | | Log out of merchant account |
|
|
| `openAllOrdersView` | | Go to the orders listing |
|
|
| `openAllProductsView` | | Go to the products listing |
|
|
| `openDashboard` | | Go to the WordPress dashboard |
|
|
| `openNewCoupon` | | Go to the new coupon editor |
|
|
| `openNewOrder` | | Go to the new order editor |
|
|
| `openNewProduct` | | Go to the new product editor |
|
|
| `openPermalinkSettings` | | Go to Settings -> Permalinks |
|
|
| `openPlugins` | | Go to the Plugins screen |
|
|
| `openSettings` | | Go to WooCommerce -> Settings |
|
|
| `runSetupWizard` | | Open the onboarding profiler |
|
|
| `updateOrderStatus` | `orderId, status` | Update the status of an order |
|
|
| `openEmailLog` | | Open the WP Mail Log page |
|
|
| `openAnalyticsPage` | | Open any Analytics page |
|
|
| `openAllUsersView` | | Open the All Users page |
|
|
| `openImportProducts` | | Open the Import Products page |
|
|
| `openExtensions` | | Go to WooCommerce -> Extensions |
|
|
| `openWordPressUpdatesPage` | | Go to Dashboard -> Updates |
|
|
| `installAllUpdates` | | Install all pending updates on Dashboard -> Updates|
|
|
| `updateWordPress` | | Install pending WordPress updates on Dashboard -> Updates|
|
|
| `updatePlugins` | | Install all pending plugin updates on Dashboard -> Updates|
|
|
| `updateThemes` | | Install all pending theme updates on Dashboard -> Updates|
|
|
| `runDatabaseUpdate` || Runs the database update if needed |
|
|
|
|
### Shopper `shopper`
|
|
|
|
| Function | Parameters | Description |
|
|
|----------|------------|-------------|
|
|
| `addToCart` | | Add an item to the cart from a single product page |
|
|
| `addToCartFromShopPage` | `productTitle` | Add an item to the cart from a single product page |
|
|
| `fillBillingDetails` | `customerBillingDetails` | Fill billing fields in checkout form using configured address |
|
|
| `fillShippingDetails` | `customerShippingDetails` | Fill shipping fields in checkout form using configured address |
|
|
| `goToAddresses` | | Go to My Account -> Address Details |
|
|
| `goToAccountDetails` | | Go to My Account -> Details |
|
|
| `goToCart` | | Go to the cart page |
|
|
| `goToCheckout` | | Go to the checkout page |
|
|
| `goToDownloads` | | Go to My Account -> Downloads |
|
|
| `goToMyAccount` | | Go to the My Account page |
|
|
| `goToOrders` | | Go to My Account -> Orders |
|
|
| `goToProduct` | `productId` | Go to a single product in the shop |
|
|
| `goToShop` | | Go to the shop page |
|
|
| `login` | | Log in as the shopper |
|
|
| `placeOrder` | | Place an order from the checkout page |
|
|
| `productIsInCheckout` | `productTitle, quantity, total, cartSubtotal` | Verify product is in cart on checkout page |
|
|
| `removeFromCart` | `productTitle` | Remove a product from the cart on the cart page |
|
|
| `setCartQuantity` | `productTitle, quantityValue` | Change the quantity of a product on the cart page |
|
|
| `searchForProduct` | | Searching for a product name and landing on its detail page |
|
|
| `emptyCart` | | Removes any products and coupons that are in the cart |
|
|
|
|
### REST API `withRestApi`
|
|
|
|
| Function | Parameters | Description |
|
|
|----------|------------|-------------|
|
|
| `resetOnboarding` | | Reset onboarding settings |
|
|
| `deleteAllCoupons` | | Permanently delete all coupons |
|
|
| `deleteAllProducts` | | Permanently delete all products |
|
|
| `deleteAllShippingZones` | | Permanently delete all shipping zones except the default |
|
|
| `deleteAllShippingClasses` | Permanently delete all shipping classes |
|
|
| `deleteCustomerByEmail` | `emailAddress` | Delete customer user account. Posts are reassigned to user ID 1 |
|
|
| `resetSettingsGroupToDefault` | `settingsGroup` | Reset settings in settings group to default except `select` fields |
|
|
| `deleteAllOrders` | | Permanently delete all orders |
|
|
|
|
### Page Utilities
|
|
|
|
| Function | Parameters | Description |
|
|
|----------|------------|-------------|
|
|
| `addProductToOrder` | `orderId, productName` | adds a product to an order using the product search |
|
|
| `applyCoupon` | `couponName` | helper method which applies a coupon in cart or checkout |
|
|
| `clearAndFillInput` | `selector, value` | Replace the contents of an input with the passed value |
|
|
| `clickFilter` | `selector` | helper method that clicks on a list page filter |
|
|
| `clickTab` | `tabName` | Click on a WooCommerce -> Settings tab |
|
|
| `clickUpdateOrder` | `noticeText`, `waitForSave` | Helper method to click the Update button on the order details page |
|
|
| `completeOnboardingWizard` | | completes the onboarding wizard with some default settings |
|
|
| `createCoupon` | `couponAmount`, `couponType` | creates a basic coupon. Default amount is 5. Default coupon type is fixed discount. Returns the generated coupon code. |
|
|
| `createGroupedProduct` | | creates a grouped product for the grouped product tests. Returns the product id. |
|
|
| `createSimpleOrder` | `status` | creates a basic order with the provided status string |
|
|
| `createSimpleProduct` | | creates the simple product configured in default.json. Returns the product id. |
|
|
| `createSimpleProductWithCategory` | `name`, `price`,`categoryName` | creates a simple product used passed values. Returns the product id. |
|
|
| `createVariableProduct` | | creates a variable product for the variable product tests. Returns the product id. |
|
|
| `deleteAllEmailLogs` | | deletes the emails generated by WP Mail Logging plugin |
|
|
| `evalAndClick` | `selector` | helper method that clicks an element inserted in the DOM by a script |
|
|
| `moveAllItemsToTrash` | | helper method that checks every item in a list page and moves them to the trash |
|
|
| `permalinkSettingsPageSaveChanges` | | Save the current Permalink settings |
|
|
| `removeCoupon` | | helper method that removes a single coupon within cart or checkout |
|
|
| `selectOptionInSelect2` | `selector, value` | helper method that searchs for select2 type fields and select plus insert value inside |
|
|
| `selectOrderAction` | `action` | Helper method to select an order action in the `Order Actions` postbox |
|
|
| `setCheckbox` | `selector` | Check a checkbox |
|
|
| `settingsPageSaveChanges` | | Save the current WooCommerce settings page |
|
|
| `uiUnblocked` | | Wait until the page is unblocked |
|
|
| `unsetCheckbox` | `selector` | Uncheck a checkbox |
|
|
| `verifyAndPublish` | `noticeText` | Verify that an item can be published |
|
|
| `verifyCheckboxIsSet` | `selector` | Verify that a checkbox is checked |
|
|
| `verifyCheckboxIsUnset` | `selector` | Verify that a checkbox is unchecked |
|
|
| `verifyPublishAndTrash` | `button, publishNotice, publishVerification, trashVerification` | Verify that an item can be published and trashed |
|
|
| `verifyValueOfInputField` | `selector, value` | Verify an input contains the passed value |
|
|
| `clickFilter` | `selector` | Click on a list page filter |
|
|
| `moveAllItemsToTrash` | | Moves all items in a list view to the Trash |
|
|
| `verifyAndPublish` | `noticeText` | Verify that an item can be published |
|
|
| `selectOptionInSelect2` | `selector, value` | helper method that searchs for select2 type fields and select plus insert value inside |
|
|
| `searchForOrder` | `value, orderId, customerName` | helper method that searchs for an order via many different terms |
|
|
| `addShippingZoneAndMethod` | `zoneName, zoneLocation, zipCode, zoneMethod` | util helper method for adding shipping zones with shipping methods |
|
|
| `applyCoupon` | `couponName` | helper method which applies a coupon in cart or checkout |
|
|
| `removeCoupon` | | helper method that removes a single coupon within cart or checkout |
|
|
| `selectOrderAction` | `action` | Helper method to select an order action in the `Order Actions` postbox |
|
|
| `clickUpdateOrder` | `noticeText`, `waitForSave` | Helper method to click the Update button on the order details page |
|
|
| `deleteAllShippingZones` | | Delete all the existing shipping zones |
|
|
| `waitForSelectorWithoutThrow` | `selector`, `timeoutInSeconds` | conditionally wait for a selector without throwing an error. Default timeout is 5 seconds |
|
|
| `createOrder` | `orderOptions` | Creates an order using the API with the passed in details |
|
|
|
|
### Test Utilities
|
|
|
|
As of version 0.1.3, all test utilities from [`@wordpress/e2e-test-utils`](https://www.npmjs.com/package/@wordpress/e2e-test-utils) are available through this package.
|