---
sourceDocument: Australia Build or modify applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/application-development

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Create a custom UI test

# Create a custom UI test {#ariaid-title1}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

Test components in custom UI pages.

## Antes de Iniciar

* Use the Page Inspector to identify testable custom UI components. See [Enable and use the page inspector](https://servicenow-prod.fluidtopics.net/4SvC7AllTj1Cg_tJHZv2uw "Enable a developer setting to inspect UI pages that open within the platform. Use the Manual Page Inspector to inspect pages that open in a new tab, such as Service Portal pages.").
* Role required: admin
{#create-custom-ui-test__ul_edr_rld_vfb}

## Procedimento

1. Navigate to AllAutomated Test FrameworkTests.
2. Click New.
3. Enter a name and description for your test.
4. Click Save.
5. In the Test Steps related list, click Add Test Step.
6. Add test steps to navigate to the target custom UI page.  
   Use the Navigate to Module step to open a page that has an application navigator module. Use the Open Service Portal Page step to open a portal page.  
   To open a UI page, use these test steps:
   1. Open an Existing Record: Open the record for the page.
   2. Click UI Action: Click the Try It UI action to open the page.
   {#create-custom-ui-test__ol_twx_dtw_5fb}
7. Add test steps from the Custom UI category to validate the behavior of custom UI components.  
   For a list of available Custom UI test steps, see [Custom UI category](https://servicenow-prod.fluidtopics.net/RGFlPP5o6jEK3jkz0E3xDA#test-steps-custom-ui-category "Validate the behavior of page components on custom user interfaces.").
8. Retrieve UI components when adding a test step.  
   Identify the testable page components on a custom UI page by retrieving a
   list of UI components for test steps. You can collect the components of the
   current page by selecting Retrieve Components.  
   The system retrieves the components using an existing or a new client test runner. Ensure that the client test runner tabs used in the retrieval process are running in the foreground. For tests that don't yield any components after selecting Retrieve Components, the following warning message is displayed and the Next button is disabled.  
   If you have already retrieved a list of page components, click Next to use the previously retrieved list. You can also click Retrieve Components to rerun the current steps and refresh the list of testable page components. If the test fails while retrieving components, the following warning notification is displayed. You can review the test results by clicking the link in the notification.  
   Nota:  
   If you need to update a step in a test, click Retrieve Components for that step and the test runs only up to that particular step. The steps beyond the selected step don't run. The test passes if all the updated steps pass without failure.

   Automated Test Framework stores the list of page components and
   displays the list in the Component values or
   Component field on the test step form. The field
   displays this information about each component:  
   {#create-custom-ui-test__table_ytn_bwf_mjb__entry__2}

   | Field | Description |
   |-|-|
   | Type | HTML element description and tag. For example, `Text<input>`. |
   | Label | HTML component label. |
   | Value | Value of the component. For example, if the component is a search input, the value might be Search. |
   | Page area | HTML layout element that contains the component such as a `<div>` or `<section>` element. |
   [ ]

   {#create-custom-ui-test__table_ytn_bwf_mjb}

   If you create a parameterized test that includes Custom UI test steps, the system only uses the first data set to retrieve components.

## O que Fazer Depois

Consider adding tests to a test suite. For more information, see [Building and running automated test suites](https://servicenow-prod.fluidtopics.net/UvV2aTEJOjiGkbS0tSpICA "Run a group of tests in a specific order to test an application or a group of related features.").