/** * Copyright (c) 2025, Salesforce, Inc. * All rights reserved. * For full license text, see the LICENSE file or https://utam.dev/salesforce/license */ import { Driver as _Driver, Element as _Element, Locator as _Locator, BaseUtamElement as _BaseUtamElement, ActionableUtamElement as _ActionableUtamElement, ClickableUtamElement as _ClickableUtamElement, UtamBasePageObject as _UtamBasePageObject, EditableUtamElement as _EditableUtamElement } from '@utam/core'; import _Icon from 'salesforce-pageobjects/lightning/pageObjects/icon'; import _BaseComboboxItem from 'salesforce-pageobjects/lightning/pageObjects/baseComboboxItem'; /** * Selector: lightning-base-combobox. * Represents the lightning-base-combobox Lightning web component. * Expand the combo box, which clicks the trigger input and waits for results to load. Enter search or trigger text, or get the entered search or trigger text. Check if the input is read only and wait for the result items to load. Retrieve the trigger icon, list of groups, list of base-combobox-item page objects, or a base-combobox-item at a specific index. Retrieve a specific base-combobox-item by text value match and the selected base-combobox-item. * generated from JSON dist/lightning/baseCombobox.utam.json * @version 2026-03-09T13:56:35.978Z * @author Salesforce */ export default class BaseCombobox extends _UtamBasePageObject { constructor(driver: _Driver, element?: _Element, locator?: _Locator); /** * Gets the html attribute of trigger input * @return string * @param attributeName Attribute name */ getInputAttribute(attributeName: string): Promise; /** * Performs click action on the trigger input and waits for dropdown list to open */ expand(): Promise; /** * Checks if the combobox is open * @return boolean */ isOpen(): Promise; /** * Removes or clears the text inside the trigger input */ clear(): Promise; /** * Sets the text as value to the trigger input * @param text Text to be entered in the trigger input */ setTriggerText(text: string): Promise; /** * Gets the text entered in the trigger input */ getTriggerText(): Promise; /** * Gets the text input value */ getInputText(): Promise; /** * Checks if combobox dropdown is opened * @return boolean */ isDropdownOpened(): Promise; /** * Checks if trigger input is disabled * @return boolean */ isDisabled(): Promise; /** * Checks if ready-only attribute is set on trigger input * @return boolean */ isReadonly(): Promise; /** * Waits for all dropdown list items to load */ waitForItemsToLoad(): Promise; /** * Check if the value is present */ hasItemByValue(dataValue: string): Promise; /** * Waits for a dropdown item to load with matching data value */ waitForItemByValue(dataValue: string): Promise; /** * Performs a click action on expand button and waits for the dropdown to open, in case combobox doesn't allow user input */ expandForDisabledInput(): Promise; /** * Performs click action on the combobox list item based on the index starting from one */ pickItem(indexStartingOne: number): Promise; /** * Performs click action on the combobox list item based on the text value */ pickItemByLabel(text: string): Promise; /** * Gets the currently focused item value and returns null if combobox is not expanded * @return string|null */ getFocusedItemValue(): Promise; /** * Sets the text as value to the trigger input * @deprecated This method will be deprecated in future release, use setTriggerText method instead. */ setSelectedItemText(text: string): Promise; /** * Clears the inputPill */ clearSelection(): Promise; /** * Select an item in the combobox by its value. */ selectItemByValue(text: string): Promise; /** * Applies focus on the input element */ focus(): Promise; getRoot(): Promise<(_BaseUtamElement & _ActionableUtamElement & _ClickableUtamElement & _EditableUtamElement)>; getTriggerInput(): Promise<(_BaseUtamElement & _ActionableUtamElement & _ClickableUtamElement & _EditableUtamElement)>; getTriggerIcon(): Promise<_Icon>; getGroups(): Promise<(_BaseUtamElement)[]>; getItems(): Promise<_BaseComboboxItem[]>; getItem(indexStartingOne: number): Promise<_BaseComboboxItem>; getItemByValue(text: string): Promise<_BaseComboboxItem>; getItemByLabel(text: string): Promise<_BaseComboboxItem>; getSelectedItemInput(): Promise<(_BaseUtamElement & _EditableUtamElement)>; getCheckedItem(): Promise<(_BaseUtamElement)>; }