Skip to main content

[WebUI] Click Offset

Attention:
  • This keyword is not supported in the Safari browser.

Description

Click on the given element with the relative position (x, y) from the in-view center point of that element. If the target element is behind a loading overlay, Katalon Studio repeatedly tries to click the element for a period configured in Project > Settings > Execution > Default wait for element timeout.

Keyword name: clickOffset

Katalon Studio Execution settings > default wait for element timeout

Parameters

ParameterParameter TypeRequiredDescription
toTestObjectYesRepresents a web element.
offsetXintYesOffset from the in-view center point of the element. A negative value means an offset left of the point.
offsetYintYesOffset from the in-view center point of the element. A negative value means an offset above the point.
flowControlFailureHandlingOptionalSpecify failure handling schema to determine whether the execution should be allowed to continue or stop. To learn more about failure handling settings, you can refer to this document: Failure handling

Example

In this example, we want to click on the top left cell of the Tic Tac Toe board. By default, the Default wait for element timeout setting is for 30 seconds. If the Tic Tac Toe board is behind a loading overlay, Katalon Studio will try clicking the button for 30 seconds maximum:

import static com.kms.katalon.core.checkpoint.CheckpointFactory.findCheckpoint
import static com.kms.katalon.core.testcase.TestCaseFactory.findTestCase
import static com.kms.katalon.core.testdata.TestDataFactory.findTestData
import static com.kms.katalon.core.testobject.ObjectRepository.findTestObject
import com.kms.katalon.core.checkpoint.Checkpoint as Checkpoint
import com.kms.katalon.core.checkpoint.CheckpointFactory as CheckpointFactory
import com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords as MobileBuiltInKeywords
import com.kms.katalon.core.model.FailureHandling as FailureHandling
import com.kms.katalon.core.testcase.TestCase as TestCase
import com.kms.katalon.core.testcase.TestCaseFactory as TestCaseFactory
import com.kms.katalon.core.testdata.TestData as TestData
import com.kms.katalon.core.testdata.TestDataFactory as TestDataFactory
import com.kms.katalon.core.testobject.ObjectRepository as ObjectRepository
import com.kms.katalon.core.testobject.TestObject as TestObject
import com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WSBuiltInKeywords
import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUiBuiltInKeywords
import internal.GlobalVariable as GlobalVariable
import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
import com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords as Mobile
import com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WS

'Open browser and navigate to Tic Tac Toe site.'
WebUI.openBrowser('https://codepen.io/solartic/full/qEGqNL/')

'Click on the top left cell'
WebUI.clickOffset(findTestObject('Object Repository/Page_CodePen - Tic Tac Toe/canvas_tic-tac-toe-board'), 100, 100)

'Close browser'
WebUI.closeBrowser()
Was this page helpful?