--- title: Testable Configurable Workspace components description: Learn about the components and its associated actions in the configurable workspace. locale: en-US canonical_url: https://www.servicenow.com/docs/r/australia/application-development/automated-test-framework-atf/atf-conf-ws-components.html release: australia product: Automated Test Framework \(ATF\) classification: automated-test-framework-atf topic_type: reference last_updated: "2026-03-12" reading_time_minutes: 22 breadcrumb: [Automated Test Framework \(ATF\) reference, Automated Test Framework \(ATF\), Testing and debugging applications, Building applications] --- # Testable Configurable Workspace components Learn about the components and its associated actions in the configurable workspace. For more information, see [Testable configurable workspace components](https://horizon.servicenow.com/workspace/components). ## Accordion item |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Check if accordion collapsed|Determines if the accordion is currently collapsed|Boolean| |Toggle accordion content|Toggles the accordion item's content| | |Get header text|Expected return value: Returns the header text value in the accordion's item trigger|String| |Get caption text|Expected return value: Returns the caption text value in the accordion's item trigger|String| ## Action bar |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Click action|Clicks an action|N/A| |Has action|Checks if an action exists|Boolean| ## Activity Stream
Actions Data values and description Data types
Select Option In Filter Set Modal Field Selects the given option in the given field in the filter set modal N/A
Apply Filter Set With Name Applies the filter set with the given name N/A
Get Journal Tile Content Returns the content of a journal tile at the given index**Note:** It can contain either HTML or text. String
Open Filter Set Edit Modal Opens the edit filter set modal with the given name N/A
Open Filter Set Modal Opens the filter set modal N/A
Set Filter Set Name Inputs the given value as the new filter set's name N/A
Create New Filter Set From Existing Selections Creates a new filter set from the current filter selections N/A
Select All Options In Filter Set Modal Field Selects all options in the given field in the filter set modal N/A
Clear Option In Filter Set Modal Field Clears the item at the given index in the given field in the filter set modal String
Get Journal Tile Field Name Returns the type of a Journal Tile \(work\_notes or comments\) at the given index String
Get Activity Tile Type Returns the type of an activity tile displayed in the activity stream N/A
Click Save Filter Set Button Clicks the save button in the filter set modal N/A
Get Filter Set Name Inputs the given value as the new filter set's name String
Open Filters Opens the filter section N/A
Can Find Filter Set With Name Expected return- True: Returns True if a filter set with the given name exists - False: Returns False if a filter set with the given name doesn't exists Boolean
Clear All Options In Filter Set Modal Field Clears all options in the given field in the filter set modal N/A
## Activity Stream Compose |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Select Field|Selects a compose journal field tab or dropdown menu|Boolean| |Is Journal Popped Out|Tests if the journal field composition for the given field name is shown as being edited outside of compose|N/A| |Is Stacked View Enabled|Tests if Stacked View is enabled|Boolean| |Is Stacked View Available|Tests if Stacked View is available|Boolean| |Is Email Popped Out|Tests if the email composition is shown as if being edited outside of compose|N/A| |Check If Tab Selected|Tests if a compose tab is selected|Boolean| |Set Journal Text|Enters text into the editor of the provided field|N/A| |Click pop-in button for journal editor|Clicks on the pop in button for journal editor|N/A| |Select Tab|Selects a compose journal field tab|Boolean| |Click pop-out button for journal editor|Clicks on the pop out button for journal editor|N/A| |Click Post Button|Clicks on the editor post button|N/A| |Click pop-in button for email editor|Clicks on the pop in button for email editor|N/A| |Get Journal Text|Reads the text in the editor of the provided field|String| |Is Using Tabs|Tests if the component is using now-tabs to display the fields|N/A| |Toggle Stacked View|Clicks the Stacked View Toggle|N/A| |Is Field Selected|Tests if a compose field is selected|N/A| |Click pop-out button for email editor|Clicks on the pop out button for email editor|N/A| ## Alert |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Check if alert collapsed|Checks if the alert is currently collapsed|Boolean| |Toggle alert collapse state|Toggles the collapse state of the alert if its collapsible|N/A| |Check if alert contains action|Determines if the alert has an action button|Boolean| |Check if alert is collapsible|Checks if the alert can be collapsed|Boolean| |Click alert button|Clicks the action button for the alert|N/A| |Get alert title|Retrieves the title of the alert|String| |Check if the alert text is focusable|Checks if the alert text can be focused|Boolean| ## Avatar
Actions Data values and description Data types
Click the avatar Clicks the avatar.**Note:** The avatar gets clicked only if the interaction mode is being set to a button or a link. N/A
Get the initials of the avatar Returns the text value of the avatar if it has initials. N/A
Check if the avatar has an image Returns true if the avatar displays an image. Boolean
Check if the avatar has initials Returns true if the avatar returns the user initials. Boolean
Check if the avatar is anonymous Checks if the avatar doesn't have an image or the user initials. Boolean
## Badge |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Get the badge text|Returns the text content of the badge|String| ## Breadcrumb |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Click item|Clicks the matching breadcrumb item|N/A| ## Button |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Click|Clicks the button|N/A| |Get Text|Expected return value: Retrieves the text of the button|String| ## Button bare |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Click|Clicks the button|N/A| |Get Text|Expected return value: Retrieves the text of the button|String| ## Button circular |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Click|Clicks the button|N/A| |Get Text|Expected return value: Retrieves the text of the button|String| ## Button iconic |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Click|Clicks the button|N/A| |Get Text|Expected return value: Retrieves the text of the button|String| ## Button stateful |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Click|Clicks the button|N/A| |Get Text|Expected return value: Retrieves the text of the button|String| ## Card Base Container
Actions Data values and description Data types
Click Clicks the card**Note:** This is applicable only for interactive cards. N/A
is Selected Expected return- True: Returns True if the card is currently marked as selected - False: Returns False if the card is currently not marked as selected Boolean
## Card Base Header |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Get Caption Text|Expected return value: Retrieves the text of the card caption|String| |Get Heading Level|Expected return value: Retrieves the heading level|String| |Get Heading Text|Expected return value: Retrieves the text of the card header|String| |Get Tagline Text|Expected return value: Retrieves the text of the card tagline|String| ## Checkbox |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Click checkbox|Clicks the checkbox|N/A| ## Collapse
Actions Data values and description Data types
Check if collapse is collapsed Expected return- True: Returns True if the collapse is currently not expanded - False: Returns False if the collapse is currently expanded N/A
## Color selector
Actions Data values and description Data types
Get trigger label Retrieves the trigger label String
Open color selector panel Opens the color selector panel popover N/A
Check if color selector panel is displayed Expected return- True: Returns True if the color selector panel is displayed - False: Returns False if the color selector panel is not displayed Boolean
## Custom popover |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Click popover trigger|Simulates a click on the slotted trigger element for the popover|N/A| |Popover panel visibility|Checks if the popover is opened and its panel is visible|Boolean| ## Date-Time
Actions Data values and description Data types
Check if item is disabled Expected return- True: Returns True if the matching item in the calendar is disabled - False: Returns False if the matching item in the calendar is enabled Boolean
Set input value Sets value on native input, includes dispatch of event N/A
Click Action Clicks the first matching footer action N/A
Check if calendar item is focused Expected return- True: Returns True if the matching item in the calendar is focused - False: Returns False if the matching item in the calendar is not focused Boolean
Check if calendar panel is displayed Expected return- True: Returns True if the calendar panel is displayed - False: Returns False if the calendar panel is not displayed Boolean
Select date item Selects the matching date item in the calendar N/A
Click on the input Clicks on the input of now-date-time and opens the calendar N/A
Check if item is selected Expected return- True: Returns True if the matching item in the calendar is selected - False: Returns False if the matching item in the calendar is not selected Boolean
## Date-Time-Interval
Actions Data values and description Data types
Set the end input value Expected return- True: Returns True if the matching item in the calendar is disabled - False: Returns False if the matching item in the calendar is enabled N/A
Check if calendar panel is displayed Sets value on native input, includes dispatch of event Boolean
Check if item is selected Clicks the first matching footer action Boolean
Click the start input Expected return- True: Returns True if the matching item in the calendar is focused - False: Returns False if the matching item in the calendar is not focused N/A
Check if calendar item is focused Expected return- True: Returns True if the calendar panel is displayed - False: Returns False if the calendar panel is not displayed Boolean
Check if preset is selected Selects the matching date item in the calendar Boolean
Check if item is disabled Clicks on the input of now-date-time and opens the calendar Boolean
Click Action Expected return- True: Returns True if the matching item in the calendar is selected - False: Returns False if the matching item in the calendar is not selected N/A
Click the end input Clicks on the start input of now-date-time and opens the calendar N/A
Select a preset Selects the matching preset item from the preset list N/A
Select a date item Selects the matching date item in the calendar N/A
Set the start input value Sets start value on native input, include dispatch of events N/A
## Dropdown
Actions Data values and description Data types
Click trigger Click the dropdown N/A
Number of selected items Returns the number of selected items in the dropdown menu Numeric
Get text Retrieves the text content of the dropdown menu String
Check selection Returns true of the matching item of the menu is selected**Note:** You also need to select a timeframe for the matching item Boolean
Check panel display Returns true of the menu is selected Boolean
Select first matching item Selects the first matching item in the menu**Note:** You also need to select a timeframe for the matching item N/A
## Flyout Menu |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Check if the flyout menu panel is displayed|Returns true if the flyout menu is opened and the list panel is visible|Boolean| |Check selection|Returns true if the matching item of the panel is selected|Boolean| |Click flyout menu trigger|Clicks the slotted trigger element for the flyout menu|N/A| |Select first matching item|Selects the first matching item found in the panel|N/A| |Number of selected items|Returns the number of selected items in the flyout menu panel|Numeric| ## Heading |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Get Text|Expected return value: Retrieves the text of the heading|String| ## Highlighted value |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Get the highlighted-value text|Expected return value: Retrieves the text of the highlighted value|String| ## Input |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Set value|Sets value on native input, includes dispatch of event|String| ## Input password |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Set value|Sets value on native input, includes dispatch of event|String| ## Input phone |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Set value|Sets value on native input, includes dispatch of event|String| ## Input URL |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Set value|Sets value on native input, includes dispatch of event|String| ## List
Actions Data values and description Data types
Apply filter on the list Applies filter on the list using encoded query Boolean
Open a record in the list Opens a record in the list by clicking on first cell link of record row Boolean
Validate record visibility in the list Validates if the record with the given sysid is present in the list Boolean
Click a list UI action button Clicks the UI action button with the given sysid Boolean
Validate the visibility of list's declarative actions Validates the visibility of declarative action buttonFor example, the **New** button. It is validated based on its sysid. Boolean
## Loader
Actions Data values and description Data types
Click the loader action Clicks the action associated with the loader N/A
Get the loader text Returns the text of the loader String
Check if loader has action Expected return- True: Returns True if the loader has an action defined - False: Returns False if the loader doesn't have an action defined Boolean
## Loader Custom |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Get the loader custom text|Returns the text of the loader custom|String| ## Modeless Dialog
Actions Data values and description Data types
Click window action Clicks the matching window action.**Note:** The matcher could correspond to the index of the button within the buttons collection. N/A
Check if dialog is closed Expected return- True: Returns True if the dialog is opened - False: Returns False if the dialog is not opened Boolean
Get the now-modeless-dialog text Returns the text of the now-modeless dialog String
## now-alert-list |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Toggle alert list collapsed state|Checks if the alert is currently collapsed|N/A| |Check if alert list can collapse|Toggles the collapse state of the alert if its collapsible|Boolean| |Dismiss alerts|Determines if the alert has an action button|N/A| |Check if alert list collapsed|Checks if the alert can be collapsed|Boolean| ## now-card-footer
Actions Data values and description Data types
Get Footer End Text Returns the text of the card footer's right side**Note:** This is the end part of the footer text String
Get Footer Text Returns the text of the card footer String
Get Footer Start Text Returns the text of the card footer's left side**Note:** This is the start part of the footer text String
## now-collapse-trigger |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Finish collapse transition|Allows now-collapse to finish transitioning|N/A| ## now-color-selector-panel
Actions Data values and description Data types
Get color name Returns the name of the color String
Select color swatch by id Selects the color swatch from color groups by the color id N/A
Set hex value Sets the hex value.**Note:** The valid value is either 3 or 6 hexadecimal characters without \#. N/A
Set color name Sets the name of the color in the color name edit input field N/A
Set slider value Sets the value of hue slider N/A
Click action Clicks the first matching footer action N/A
Set rgb value Sets the rgb value N/A
Set hsl value Sets the hsl value N/A
## now-date-time-calendar
Actions Data values and description Data types
Check if item is disabled Expected return- True: Returns True if the matching item in the calendar is disabled - False: Returns False if the matching item in the calendar is enabled Boolean
Check if item is focused Expected return- True: Returns True if the matching item in the calendar is focused - False: Returns False if the matching item in the calendar is not focused Boolean
Get active month Returns a numeric value of the currently selected month Numeric
Check if item is selected Expected return- True: Returns True if the matching item in the calendar is selected - False: Returns False if the matching item in the calendar is not selected Boolean
Get active year Returns a numeric value of the currently selected year Numeric
Select date item Selects the matching date item in the calendar N/A
## now-dropdown-custom-target
Actions Data values and description Data types
Check panel display Expected return- True: Returns True if the panel is displayed - False: Returns False if the if the panel is not displayed Boolean
Select first matching item Selects the first matching item found in the panel N/A
Check selection Expected return- True: Returns True if the matching item in the panel is selected - False: Returns False if the matching item in the panel is not selected Boolean
Number of selected items Returns the number of selected items in the dropdown panel Numeric
## now-dropdown-list
Actions Data values and description Data types
Check if item is selected Checks if the item is selected in the panel Boolean
Get selected items count Retrieves the number of items currently selected within the dropdown panel Numeric
Check panel display Expected return- True: Returns True if the panel is displayed - False: Returns False if the panel is not displayed Boolean
Get panel item count Returns the number of items in the dropdown panel Numeric
Select first matching item Selects the first matching item in the panel N/A
## now-flyout-menu-list
Actions Data values and description Data types
Get number of selected items Returns the number of selected items in the flyout-menu panel Numeric
Get number of items Returns the number of items in the flyout-menu panel Numeric
Check if the flyout menu panel is displayed Expected return- True: Returns True if the panel is displayed - False: Returns False if the panel is not displayed Boolean
Select item Selects the first matching item in the panel N/A
Check if item is selected Expected return- True: Returns True if the matching item in the panel is selected - False: Returns False if the matching item in the panel is not selected Boolean
## now-input-date-time |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Set input value|Sets value on native input, includes dispatch of event|N/A| ## now-modal
Actions Data values and description Data types
Is Displayed Expected return- True: Returns True if the modal is currently displayed - False: Returns False if the modal is currently not displayed Boolean
Get Content Returns the text of the modal N/A
Has Footer Expected return- True: Returns True if the modal contains a footer - False: Returns False if the modal doesn't contain a footer Boolean
Dismiss Clicks the dismiss action of the modal N/A
Get Heading Returns the heading value of the modal String
Click Action Clicks the first matching footer action N/A
## now-record-list-connected |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Apply filter on the list|Applies the filter in the form of encodedQuery|N/A| |Click a list UI action button|Selects a UI action button in the list|N/A| |Validate record visibility in the list|Validates if the selected record is visible in the list|Boolean| |Validate the visibility of list's declarative actions|Validates if the list's declarative action is visible or not|Boolean| |Open a record in the list|Opens the selected record from the list|N/A| ## now-tabs
Actions Data values and description Data types
Select tab by matcher Selects a tab based on the provided criteria**Note:** It also allows substring matching N/A
Check if matching tab is selected Checks if the tab matching the provided criteria is currently selected Boolean
## now-tabs-vertical
Actions Data values and description Data types
Check if matching tab is selected Checks if the tab matching the provided criteria is currently selected N/A
Select tab by matcher Selects a tab based on the provided criteria**Note:** It also allows substring matching Boolean
## now-uxf-tab-set
Actions Data values and description Data types
Assert tab selected by label Returns true if the tab with the given label is present. An error is shown if the tab is not found.**Note:** You must enter the exact name in the label to check if it exists. Boolean
Select tab by order Selects a tab by its order in the tab set. The order starts from 1.**Note:** You must enter the required order of the tab you want to be selected. N/A
Select tab by label Selects a tab by its label.**Note:** You must enter the required label of the tab you want to be selected. N/A
## pagination-control |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Get page label|Returns page label|String| |Check if page selected|Checks if the page matching the provided criteria is currently selected|Boolean| |Select page size|Selects a page size from the dropdown control|N/A| |Click go-to-next-page button|Simulates a click on the go-to-next-page button|N/A| |Set input value|Sets value on input field and dispatches associated events|N/A| |Click go-to-last-page button|Simulates a click on the go-to-last-page button|N/A| |Click go-to-previous-page button|Simulates a click on the go-to-previous-page button|N/A| |Click go-to-first-page button|Simulates a click on the go-to-first-page button|N/A| ## pill
Actions Data values and description Data types
Get the pill text Returns the text content of the pill String
Dismiss pill Clicks the dismiss button of the pill N/A
Check if pill is dismissible Expected return- True: Returns True if the pill is dismissible - False: Returns False if the pill is not dismissible Boolean
Click pill Clicks the pill N/A
## Radio buttons |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Select a radio button|Clicks the matching radio button, toggling its selected state|N/A| ## Select |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Click trigger element|Simulates a click on the trigger element|N/A| |Check if dropdown displayed|Determines if the dropdown list is currently visible on the screen|Boolean| |Select matching item|Selects the matching item in the dropdown list|N/A| ## sn-canvas-tabs
Actions Data values and description Data types
Assert tab with label exist Returns true if the tab with the required label exist Boolean
Assert tab with label is selected Returns true if the tab with the required label is selected Boolean
Close tab by order Closes the tab by its order in the tab set. The order starts from 1.**Note:** You must enter the required order of the tab you want to be closed. N/A
Close tab with label Closes the tab by its label in the tab set.**Note:** You must enter the required label of the tab you want to be closed. N/A
Select tab by order Selects a tab by its order in the tab set. The order starts from 1.**Note:** You must enter the required order of the tab you want to be selected. N/A
Select tab with label Selects a tab by its label.**Note:** You must enter the required label of the tab you want to be selected. N/A
## sn-canvas-toolbar
Actions Data values and description Data types
Assert button exists by group and tool tip Verifies that a button with the given tooltip is present within the group.- group: top or bottom - toolTip: - Expected return - True: Returns True if a button with the given tooltip is present within the group - False: Returns False if a button with the given tooltip is not present within the group Boolean
Assert button selected by group and tool tip Selects a button with the given tooltip within the group. Boolean
Select button by group and order Selects a button within the toolbar group by its ordering. The order starts from 1. Groups can either be top or bottom. N/A
Select button by group and tool tip Selects a button within the toolbar group by its toolTip values. The order starts from 1. ToolTip value N/A
## Split button
Actions Data values and description Data types
Is Panel Displayed Expected return- True: Returns True if the panel is displayed - False: Returns False if the panel is not displayed Boolean
Is Item Selected Returns true if the panel's matching item is selectedExpected return- True: Returns True if the matching item in the panel is selected - False: Returns False if the matching item in the panel is not selected Boolean
Click Clicks the primary action of the split-button N/A
Get button text Returns the text content of the split-button String
Click Trigger Clicks the split-button's dropdown trigger N/A
Select Item Selects the first matching item found in the panel N/A
Count Selected Items Returns the number of selected items in the dropdown panel of the split-button Numeric
## Stepper
Actions Data values and description Data types
Is Step Selected Expected return- True: Returns True if the step is currently selected - False: Returns False if the step is currently not selected Boolean
Click next page button Clicks the next page button N/A
Click previous page button Clicks the previous page button N/A
Select a step Selects a step N/A
## Tabs
Actions Data values and description Data types
Select tab by order Selects a tab by its order in the tab set**Note:** The order starts at 1. Boolean
Select tab by label Selects a tab by its label**Note:** An error is shown if the tab is not found. N/A
Assert tab selected by label Asserts that a tab with the given label is selected.**Note:** An error is shown if the tab is not found. N/A
## Test link |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Get text|Returns the text of the text-link|String| |Click|Clicks the link|N/A| ## Text area |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Set textarea value|Sets value on native textarea, includes dispatch of events|N/A| ## Toggle |Actions|Data values and description|Data types| |-------|---------------------------|----------| |Click trigger element|Simulates a click on the trigger element|N/A| ## Typeahead
Actions Data values and description Data types
Set input value Sets value on typeahead input and dispatches associated events N/A
Select item Selects one of the items of the typeahead N/A
Click the input Clicks on the input of the typeahead N/A
Check if panel is displayed Expected return- True: Returns True if the panel is opened and visible - False: Returns False if the panel is not opened and visible Boolean
## Typeahead multi
Actions Data values and description Data types
Select item Selects one of the items of the typeahead N/A
Click the input Clicks on the input of the typeahead N/A
Check if panel is displayed Expected return- True: Returns True if the panel is opened and visible - False: Returns False if the panel is not opened and visible Boolean
Set input value Sets value on typeahead input and dispatches associated events N/A
- **[Configurable workspace components examples](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/atf-conf-ws-comp-examples.md)** To grasp how to interact with configurable workspace components, review these examples. **Parent Topic:**[Automated Test Framework \(ATF\) reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/atf-ref-overview.md)