def wait_appear(
locator: Union[_Locator, str],
locator_variables: dict = {},
wait_timeout: int = 30
) -> WebElement

Wait for the specified element of the web page to appear within given timeout.

BrowserTab.wait_appear is different with clicknium.wait_appear when locating the UI element.

  • clicknium.wait_appear() is for both the web and window UI element, and not limited to a specific scope.
  •"").wait_appear() 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 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.
 wait_timeout: int
   Wait timeout for the operation, the unit is second, default value is 30 seconds.

 WebElement object, or None if the element does not appear.


from clicknium import clicknium as cc, locator

chrome_tab ="")

# wait element appear
element = chrome_tab.wait_appear(

# parametric locator
variables = {"name":"test"}
element = chrome_tab.wait_appear(, variables)


What are your feelings
Updated on 29 August 2023