https://github.com/sbabcoc/salesforce-example

This salesforce-example project implements page models of the Salesforce Lightning Web Components example site.
https://github.com/sbabcoc/salesforce-example

salesforce salesforce-lightning selenium selenium-foundation shadow-dom

Last synced: 25 days ago
JSON representation

This salesforce-example project implements page models of the Salesforce Lightning Web Components example site.

• Host: GitHub
• URL: https://github.com/sbabcoc/salesforce-example
• Owner: sbabcoc
• Created: 2020-06-29T19:44:47.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-06-08T04:27:32.000Z (over 1 year ago)
• Last Synced: 2023-08-25T02:38:15.614Z (about 1 year ago)
• Topics: salesforce, salesforce-lightning, selenium, selenium-foundation, shadow-dom
• Language: Java
• Homepage:
• Size: 45.9 KB
• Stars: 4
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Introduction

This **salesforce-example** project implements page models of the **Salesforce** `Lightning Web Components` [example site](https://web.archive.org/web/20220324080440/https:/conference-lwc-app.herokuapp.com/). The example site this project targets has been archived. The tests have been updated to run against the last available archived instance.

## Page Model Structure

The page classes presented in this project are built on the [Selenium Foundation](https://github.com/Nordstrom/Selenium-Foundation) framework. A common [AppPage](https://github.com/sbabcoc/salesforce-example/blob/master/src/main/java/com/github/sbabcoc/model/AppPage.java) 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](https://github.com/sbabcoc/salesforce-example/blob/master/src/main/java/com/github/sbabcoc/model/LightningConferenceRoot.java)" page of the site includes a shadow DOM [session list](https://github.com/sbabcoc/salesforce-example/blob/master/src/main/java/com/github/sbabcoc/model/SessionList.java), which contains a mapped collection of [class session](https://github.com/sbabcoc/salesforce-example/blob/master/src/main/java/com/github/sbabcoc/model/ClassSession.java) page components.

## Demonstrated Features

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.