Editing Page Objects

Page Objects can be edited just as easily as test cases, and once created, they are available for reuse across an entire project. Editing options are available both from the Test Listing page and in Slider View, giving you flexibility in how you manage and update them.

Accessing and Managing Page Objects

  1. Open a Project: Navigate to the Test Listing page for your project.
  2. Select Page Objects: Click the Page Objects tab in the left sidebar panel.
  3. Use the Actions Menu: Under the Actions column for each Page Object, click the Action button to open a menu with the following options:
    • View – Opens the PO Details page.
    • Rename Page Object – Opens a modal to update the Page Object’s name.
    • Delete – Permanently removes the Page Object.

Renaming Page Objects

  • From the Actions menu, select Rename Page Object to open the rename modal.
  • Alternatively, from the PO Details page, hover over the Page Object name in the file path and click the pencil icon to edit it directly.

Page Object Settings

From the Settings menu on the PO Details page, you can access:

  • Audit Log – Review the history of changes.
  • Bulk Update Actions – Apply updates across multiple actions at once.
  • Bulk Delete Actions – Remove multiple actions simultaneously.
  • Set as Global – Convert the Page Object between global and local.
    • Local page objects can only be used in tests that are in the same project.
    • Global page objects can be used in tests in any project.
  • Lock Page Object – Lock the Page Object to prevent edits.

Note: Only Site Admins, Team Admins, and Project Admins can interact with the Lock Page Object option.

Inserting Actions into a Page Object

  1. Hover Between Actions: Hover over the space between existing actions to reveal the Insert Action button.
  2. Choose an Action: Click the button to open the Insert menu and select the desired action type.
    • A modal will appear, prompting you to set any required parameters.
    • A second modal will confirm the insertion and show the number of tests currently using the Page Object.
  3. Action Added: The action is now part of the Page Object.

Note: Element-based actions can only be added via Slider View.

Editing Page Object Actions

Each action within a Page Object contains the same settings and controls as actions in test cases.

  • Expand Action Banner – Reveal the action details.
  • Tabs Available:
    • Settings tab – Configure action-level settings.
    • Advanced tab – Access advanced options.
  • Action Buttons:
    • Delete Action
    • Local Edit
    • Clone Action

Editing Page Objects in Slider View

  1. Open Slider View: From the Test Listing or PO Details page, click View next to any action to open the Page Object in Slider View.
  2. Action Settings
    • Click the gear icon to access full settings.
    • Open the Actions menu for delete and quick-edit options.
  3. Quick Add and Local Edit
    • Use Action Quick Add or the Local Edit button for faster updates.
    • Expand actions to access flags such as:
      • Skip Action
      • Enable Force React
      • Positional Selection
  4. Insert Actions in Slider View
    Click the Quick Add button at a step to insert an action.
    Note: Only non-element-based actions can be added from Slider View.

Additional Notes

  • When a Page Object is included in a test case, all of its editing functionality remains available.
  • The Page Object Details page includes a count of the number of test cases the PO is used in. Clicking this link will provide the detailed list of test cases.
  • Slider View also provides advanced features such as:
    • Smart Screenshots for Quick Select and Quick Add.
    • Quick Select, which applies only to that specific test and browser (does not alter the Page Object globally).
  • Page Object Parameterization allows you to pass in different data for the same Page Object across multiple test cases without modifying the original.
  • The Action ID for page object actions have a PO-specific suffix appended to the original ID to help identify unique Page Objects in case they are used repeatedly in a test case.