Browser Extension (Beta)

When you write a test for a Salesforce application page, it's often confusing to know which page objects (POs) to use. To make this page object selection process easier, use UTAM's browser extension for Google Chrome. It presents you with the appropriate set of POs for the page that you're currently browsing, and identifies which page elements are affected by the methods in a selected PO.

For a quick introduction to the browser extension, watch this video.

Note: This feature is a Beta Service. Customer may opt to try such Beta Service in its sole discretion. Any use of the Beta Service is subject to the applicable Beta Services Terms provided at Agreements and Terms.

Workflow for Browser Extension

This section shows you how to use the browser extension.

Step 1: Install Browser Extension

Install the UTAM browser extension from the Chrome Web Store.

Note: Currently, we have a browser extension for Chrome only. We're considering support for other browsers in the future.

After installation, you can see the extension in your browser's toolbar.

UTAM browser extension in the toolbar

Step 2: Download Page Object Artifact

The browser extension reads UTAM POs contained in an artifact downloaded from an artifact repository. An artifact is either a zip file (.zip, .jar) or a gzipped tar file (.tar.gz, .tgz).

Prerequisite: The browser extension doesn't automatically download these artifacts. Before you can use the browser extension, you must obtain an artifact as a prerequisite step.

Get UTAM POs from an artifact published to Maven Central Repository or NPM.

To get the artifact for JavaScript page objects, run this command from the command line:

npm pack salesforce-pageobjects

This command downloads a gzipped tar file of the artifact to the current directory.

For more information about the PO artifacts for Java and JavaScript, see Downloads.

Step 3: Load Page Objects into the Browser Extension

After you install the browser extension, load the page objects that you previously downloaded in the artifact.

  1. Navigate to a Salesforce page.
  2. In Chrome, click View > Developer > Developer Tools and click the UTAM subtab in the Developer Tools pane.
  3. To import the POs from the downloaded artifact, click the Import button.

Import POs from the artifact

Navigate to the PO artifact that you downloaded earlier and click Open.

Step 4: Identify Page Objects for a Web Page

To use the browser extension on a page to be tested, you must identify a root page object:

  1. In the UTAM tab, click Find.

Find root page object

  1. You see a tree list of POs that you can navigate to find methods of interest for your test.

Tree list of page objects

  1. Hover over a PO in the list to see an outline in the browser window for the element represented by the PO.

  2. Click the > icon at the beginning of a PO name to see the methods available for the PO.

  3. If a method takes an argument, you can use the Add arguments input on the right side of the panel to enter an argument value. In this example, we select getActionRendererWithTitle(text).

Select a PO method

  1. Enter New Contact in the Add Arguments input and click Apply to highlight the New Contact button in the Account header.

Hover over a method

  1. After you've selected all the methods of interest, select Java or JavaScript in the Code Output dropdown and click the Copy Generated Code button. The code to access the selected PO methods is copied to the clipboard.

Copy the selected code

  1. Paste the code into a UTAM test in your IDE of choice. In this example, the copied Java code is:
    .getActionRendererWithTitle("New Contact");

Import a New Page Object Artifact

The Settings subtab in the UTAM panel shows you the current version of the page object artifact that you're using.

Hover over a method

To import a new page object artifact, click Clear & import new.

On the Settings page, you can also choose Java or JavaScript as the default code output to use when you Copy Generated Code to the clipboard.

See Also: