🍺 Join Clicknium for quality support, growth opportunities, and a supportive community


def is_existing(
locator: Union[_Locator, str],
locator_variables: dict = {},
timeout: int = 30
) -> bool

Check whether the specified element of the web page exists.

BrowserTab.is_existing is different with the method clicknium.is_existing when locating the UI element.

  • clicknium.is_existing() is for both web and window UI element, and not limited to a specific scope.
  • clicknium.chrome.open("https://bing.com").is_existing() will locate element in its parent web page.

 locator[Required]: str | _Locator
   Locator string, the visit path of locator for target UI element, eg: ‘locator.chrome.bing.search_sb_form_q’, locator store is chrome, and locator name is search_sb_form_q. For more details, please refer to Locator.
 locator_variables: dict
   Locator variables, set to initialize parameters in locator, eg: { "row": 1, "column": 1}, more about variables, please refer to Parametric Locator.
 timeout: int
   Timeout for the operation, the unit is second, and the default value is 30 seconds.

 Return True if UI element exists, otherwise return False


from clicknium import clicknium as cc, locator, ui

chrome_tab = cc.chrome.open("https://bing.com")

# check element if exist

# parametric locator
variables = {"name":"test"}
chrome_tab.is_existing(locator.chrome.bing.search_sb_form_q, variables)


What are your feelings
Updated on 29 August 2023