https://docs-production-katalon.netlify.app/assets/js/b382130c.68840fbf.js

1"use strict";(self.webpackChunkKatalon_Docs=self.webpackChunkKatalon_Docs||[]).push([[11015],{243:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>d,contentTitle:()=>r,default:()=>m,frontMatter:()=>c,metadata:()=>s,toc:()=>l});const s=JSON.parse('{"id":"keywords/keyword-description-in-katalon-studio/web-ui-keywords/webui-click","title":"[WebUI] Click","description":"Description","source":"@site/docs/katalon-studio/keywords/keyword-description-in-katalon-studio/web-ui-keywords/webui-click.md","sourceDirName":"keywords/keyword-description-in-katalon-studio/web-ui-keywords","slug":"/keywords/keyword-description-in-katalon-studio/web-ui-keywords/webui-click","permalink":"/katalon-studio/keywords/keyword-description-in-katalon-studio/web-ui-keywords/webui-click","draft":false,"unlisted":false,"tags":[],"version":"current","lastUpdatedAt":1758935351000,"frontMatter":{"title":"[WebUI] Click"},"sidebar":"katalon-studio","previous":{"title":"[WebUI] Clear Text","permalink":"/katalon-studio/keywords/keyword-description-in-katalon-studio/web-ui-keywords/webui-clear-text"},"next":{"title":"[WebUI] Click Image","permalink":"/katalon-studio/keywords/keyword-description-in-katalon-studio/web-ui-keywords/webui-click-image"}}');var n=a(74848),i=a(28453),o=a(86025);const c={title:"[WebUI] Click"},r="[WebUI] Click",d={},l=[{value:"Description",id:"description",level:2},{value:"Parameters",id:"parameters",level:2},{value:"Example",id:"example",level:2}];function _(e){const t={code:"code",h1:"h1",h2:"h2",header:"header",pre:"pre",...(0,i.R)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(t.header,{children:(0,n.jsx)(t.h1,{id:"webui-click",children:"[WebUI] Click"})}),"\n",(0,n.jsx)(t.h2,{id:"description",children:"Description"}),"\n",(0,n.jsxs)("p",{xmlns:"http://www.w3.org/1999/xhtml",className:"p",children:["Click on the given element. If the target element is behind a loading overlay, Katalon Studio repeatedly tries clicking the element for a period of time as configured in ",(0,n.jsxs)("span",{className:"ph menucascade",children:[(0,n.jsx)("span",{className:"ph uicontrol",children:"Project"}),(0,n.jsx)("abbr",{title:"and then",children:" > "}),(0,n.jsx)("span",{className:"ph uicontrol",children:"Settings"}),(0,n.jsx)("abbr",{title:"and then",children:" > "}),(0,n.jsx)("span",{className:"ph uicontrol",children:"Execution"}),(0,n.jsx)("abbr",{title:"and then",children:" > "}),(0,n.jsx)("span",{className:"ph uicontrol",children:"Default wait for element timeout"})]}),"."]}),"\n",(0,n.jsxs)("p",{xmlns:"http://www.w3.org/1999/xhtml",className:"p",children:["Keyword name: ",(0,n.jsx)("code",{className:"ph codeph",children:"click"})]}),"\n",(0,n.jsxs)("p",{xmlns:"http://www.w3.org/1999/xhtml",className:"p",children:[(0,n.jsx)("img",{className:"image",src:(0,o.Ay)("https://github.com/katalon-studio/docs-images/raw/master/katalon-studio/docs/wait-for-element-timeout/KS-OVERLAY-Default-timeout-settings.png"),width:700,alt:"Default wait for element timeout settings"}),(0,n.jsx)("br",{}),(0,n.jsx)("br",{})]}),"\n",(0,n.jsx)(t.h2,{id:"parameters",children:"Parameters"}),"\n",(0,n.jsxs)("table",{xmlns:"http://www.w3.org/1999/xhtml",className:"table anchor_top_offset",id:"id_0__113e9f03-ca86-4064-be94-53c9f22f66d1",children:[(0,n.jsx)("caption",{}),(0,n.jsxs)("colgroup",{children:[(0,n.jsx)("col",{style:{width:"20%"}}),(0,n.jsx)("col",{style:{width:"20%"}}),(0,n.jsx)("col",{style:{width:"20%"}}),(0,n.jsx)("col",{style:{width:"40%"}})]}),(0,n.jsx)("thead",{className:"thead",children:(0,n.jsxs)("tr",{className:!0,children:[(0,n.jsx)("th",{className:"entry anchor_top_offset",id:"id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__1",children:"Parameter"}),(0,n.jsx)("th",{className:"entry anchor_top_offset",id:"id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__2",children:"Parameter Type"}),(0,n.jsx)("th",{className:"entry anchor_top_offset",id:"id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__3",children:"Required"}),(0,n.jsx)("th",{className:"entry anchor_top_offset",id:"id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__4",children:"Description"})]})}),(0,n.jsxs)("tbody",{className:"tbody",children:[(0,n.jsxs)("tr",{className:!0,children:[(0,n.jsx)("td",{className:"entry",headers:"id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__1 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__2 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__3 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__4 ",children:"to"}),(0,n.jsx)("td",{className:"entry",headers:"id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__1 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__2 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__3 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__4 ",children:"TestObject"}),(0,n.jsx)("td",{className:"entry",headers:"id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__1 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__2 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__3 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__4 ",children:"Yes"}),(0,n.jsx)("td",{className:"entry",headers:"id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__1 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__2 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__3 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__4 ",children:"Represents a web element."})]}),(0,n.jsxs)("tr",{className:!0,children:[(0,n.jsx)("td",{className:"entry",headers:"id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__1 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__2 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__3 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__4 ",children:"flowControl"}),(0,n.jsx)("td",{className:"entry",headers:"id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__1 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__2 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__3 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__4 ",children:"FailureHandling"}),(0,n.jsx)("td",{className:"entry",headers:"id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__1 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__2 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__3 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__4 ",children:"Optional"}),(0,n.jsxs)("td",{className:"entry",headers:"id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__1 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__2 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__3 id_0__113e9f03-ca86-4064-be94-53c9f22f66d1__entry__4 ",children:["Specify ",(0,n.jsx)("a",{className:"xref",href:"/katalon-studio/maintain-tests/configure-failure-handling-settings-in-katalon-studio",children:"failure handling"})," schema to determine whether the execution should be allowed to continue or stop."]})]})]})]}),"\n",(0,n.jsx)(t.h2,{id:"example",children:"Example"}),"\n",(0,n.jsxs)("p",{xmlns:"http://www.w3.org/1999/xhtml",className:"p",children:["In this example, we want to click on the ",(0,n.jsx)("span",{className:"ph uicontrol",children:"Make Appointment"})," button. By default, the Default wait for element timeout setting is for 30 seconds. If the ",(0,n.jsx)("span",{className:"ph uicontrol",children:"Make Appointment"})," button is behind a loading overlay, Katalon Studio will try clicking the button for 30 seconds maximum:"]}),"\n",(0,n.jsx)(t.pre,{children:(0,n.jsx)(t.code,{className:"language-jsx",children:"import static com.kms.katalon.core.checkpoint.CheckpointFactory.findC

1heckpoint\nimport static com.kms.katalon.core.testcase.TestCaseFactory.findTestCase\nimport static com.kms.katalon.core.testdata.TestDataFactory.findTestData\nimport static com.kms.katalon.core.testobject.ObjectRepository.findTestObject\nimport com.kms.katalon.core.checkpoint.Checkpoint as Checkpoint\nimport com.kms.katalon.core.checkpoint.CheckpointFactory as CheckpointFactory\nimport com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords as MobileBuiltInKeywords\nimport com.kms.katalon.core.model.FailureHandling as FailureHandling\nimport com.kms.katalon.core.testcase.TestCase as TestCase\nimport com.kms.katalon.core.testcase.TestCaseFactory as TestCaseFactory\nimport com.kms.katalon.core.testdata.TestData as TestData\nimport com.kms.katalon.core.testdata.TestDataFactory as TestDataFactory\nimport com.kms.katalon.core.testobject.ObjectRepository as ObjectRepository\nimport com.kms.katalon.core.testobject.TestObject as TestObject\nimport com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WSBuiltInKeywords\nimport com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUiBuiltInKeywords\nimport internal.GlobalVariable as GlobalVariable\nimport com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI\nimport com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords as Mobile\nimport com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WS\n\n'Open browser and navigate to demo AUT site.'\nWebUI.openBrowser(GlobalVariable.G_SiteURL)\n\n'Click on 'Book Appointment' button'\nWebUI.click(findTestObject('Page_CuraHomepage/btn_MakeAppointment'))\n\n'Close browser'\nWebUI.closeBrowser()\n"})}),"\n",(0,n.jsxs)("div",{xmlns:"http://www.w3.org/1999/xhtml",className:"p",children:["Alternatively, you can try ",(0,n.jsx)("a",{className:"xref",href:"/katalon-studio/keywords/keyword-description-in-katalon-studio/web-ui-keywords/webui-execute-javascript",children:"[WebUI] Execute JavaScript"})," to click the element, as shown in the example code below: "]}),"\n",(0,n.jsx)(t.pre,{children:(0,n.jsx)(t.code,{className:"language-jsx",children:"WebElement element = WebUiCommonHelper.findWebElement(findTestObject('your/object'),30)\nWebUI.executeJavaScript(\"arguments[0].click()\", Arrays.asList(element))\n"})})]})}function m(e={}){const{wrapper:t}={...(0,i.R)(),...e.components};return t?(0,n.jsx)(t,{...e,children:(0,n.jsx)(_,{...e})}):_(e)}},28453:(e,t,a)=>{a.d(t,{R:()=>o,x:()=>c});var s=a(96540);const n={},i=s.createContext(n);function o(e){const t=s.useContext(i);return s.useMemo((function(){return"function"==typeof e?e(t):{...t,...e}}),[t,e])}function c(e){let t;return t=e.disableParentContext?"function"==typeof e.components?e.components(n):e.components||n:o(e.components),s.createElement(i.Provider,{value:t},e.children)}}}]);