Testable Configurable Workspace components

reference australia Updated Sep 10, 2026 22 min read atf-conf-ws-components.md
Raw file servicenow.com

Learn about the components and its associated actions in the configurable workspace.

For more information, see Testable configurable 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 indexNote: 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
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 cardNote: 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 selectedNote: 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 menuNote: 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

Actions

Data values and description

Data types

Get Footer End Text

Returns the text of the card footer's right sideNote: 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 sideNote: 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 criteriaNote: 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 criteriaNote: 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 setNote: The order starts at 1.

Boolean

Select tab by label

Selects a tab by its labelNote: 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

Search documentation
Search document titles and file paths on the australia branch