This salesforce-example project implements page models of the Salesforce Lightning Web Components example site. The example site this project targets has been archived. The tests have been updated to run against the last available archived instance.
The page classes presented in this project are built on the Selenium Foundation framework. A common AppPage base class provides the shadow DOM context that encapsulates the actual content of the page. Logical units of functionality within each page are modeled as shadow DOM components and conventional page components. For example, the initial "root" page of the site includes a shadow DOM session list, which contains a mapped collection of class session page components.
This example project demonstrates the following features:
-
Page model structure...
- ... pages
- ... conventional page components
- ... shadow DOM components
- ... component collections
-
Site manipulation...
- ... element location
- ... element interaction
- ... transition synchronization
This last feature (transition synchronization) is especially important to the stability of the model. Automation with inadequate synchronization is prone to non-deterministic behavior, which can trigger false negatives - test failures that indicate errors that don't actually exist. The transition synchronization facilities provided by Selenium Foundation enable the creation of stable page models with minimal custom implementation.