{"id":935,"date":"2023-08-16T15:13:21","date_gmt":"2023-08-16T06:13:21","guid":{"rendered":"http:\/\/www.charleskwon.com\/?p=935"},"modified":"2023-08-17T19:17:16","modified_gmt":"2023-08-17T10:17:16","slug":"automatic-login-through-dom-automation","status":"publish","type":"post","link":"https:\/\/www.charleskwon.com\/?p=935","title":{"rendered":"Automatic Login Through DOM Automation"},"content":{"rendered":"\n

<\/a><\/p>\n\n\n\n

Using the DOM allows you to access a website and automatically log in.
It can also automatically insert values into complex “form” elements.<\/p>\n\n\n\n

However, DOM automation involves many technical considerations.
For this example, the following methods and functions were added:<\/p>\n\n\n\n

METOD & fUNCTOIN List<\/h2>\n\n\n\n
<\/div>\n\n\n\n

METHOD Eval( cEval )
METHOD SetValue( cSelector, cValue )
METHOD Click( cSelector )<\/p>\n\n\n\n

FUNCTION AWait_SetValue( oWeb, cSelector, cValue )
FUNCTION AWait_Click( oWeb, cSelector )<\/p>\n\n\n\n

The example demonstrates automatically entering an ID on Yahoo.com’s login page and clicking the ‘next’ button.<\/p>\n\n\n\n

By applying this technique, you can enter desired values into complex forms.<\/p>\n\n\n\n

<\/p>\n\n\n\n

\n

This program provides a way for developers familiar with synchronous programming to interact with the inherently asynchronous TWebView control by emulating synchronous behavior. This can be particularly useful in scenarios where one needs to ensure a webpage is fully loaded or a specific element is present before taking further action.<\/p>\n\n\n\n

\"\"<\/figure>\nby Otto with ChatGPT<\/cite><\/blockquote>\n\n\n\n

sample Code<\/h2>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
\/*<\/span><\/span>\nc)copyright 2023-\u00a0charleskwonohjun@gmail.com\u00a0( Seoul, Korea )<\/span><\/span>\n*\/<\/span><\/span>\n#<\/span>include<\/span> <\/span>"<\/span>FiveWin.ch<\/span>"<\/span><\/span>\n<\/span>\nSTATIC oWebView  <\/span><\/span>\n<\/span>\nFUNCTION <\/span>Main<\/span>()<\/span><\/span>\n    LOCAL oDlg<\/span><\/span>\n<\/span>\n    DEFINE DIALOG oDlg TITLE <\/span>"<\/span>WebView Test<\/span>"<\/span> SIZE <\/span>1200<\/span>,<\/span> <\/span>700<\/span><\/span>\n<\/span>\n         oDlg:bStart :<\/span>=<\/span> <\/span>{<\/span> <\/span>||<\/span> <\/span>GetOuterHtml<\/span>(<\/span> oDlg  <\/span>)<\/span> <\/span>}<\/span><\/span>\n<\/span>\n    ACTIVATE DIALOG oDlg CENTER<\/span><\/span>\n      <\/span><\/span>\nRETURN NIL<\/span><\/span>\n<\/span>\n<\/span>\nSTATIC FUNCTION <\/span>GetOuterHtml<\/span>(<\/span> oDlg  <\/span>)<\/span><\/span>\n   LOCAL cStr<\/span><\/span>\n   LOCAL nCounter :<\/span>=<\/span> <\/span>0<\/span><\/span>\n   LOCAL lOk  :<\/span>=<\/span> .f.<\/span><\/span>\n<\/span>\n   oWebView :<\/span>=<\/span> <\/span>TWebView<\/span>()<\/span>:<\/span>New<\/span>(<\/span> <\/span>,<\/span> oDlg:hWnd <\/span>)<\/span><\/span>\n   oWebView:<\/span>Navigate<\/span>(<\/span> <\/span>"<\/span>https:\/\/login.yahoo.com\/<\/span>"<\/span> <\/span>)<\/span><\/span>\n<\/span>\n   <\/span>SysWait<\/span>()<\/span><\/span>\n   <\/span>Sleep<\/span>(<\/span>3000<\/span>)<\/span><\/span>\n   <\/span>SysWait<\/span>()<\/span><\/span>\n   <\/span><\/span>\n   WHILE .T.<\/span><\/span>\n      <\/span><\/span>\n      <\/span>++<\/span>nCounter<\/span><\/span>\n      cStr :<\/span>=<\/span> <\/span>AWait_QuerySelector<\/span>(<\/span> oWebView<\/span>,<\/span> <\/span>"<\/span>document.readyState<\/span>"<\/span>,<\/span> <\/span>3000<\/span> <\/span>)<\/span>  <\/span><\/span>\n<\/span>\n      IF cStr <\/span>==<\/span> <\/span>"<\/span>complete<\/span>"<\/span><\/span>\n         lOk :<\/span>=<\/span> .t.<\/span><\/span>\n         EXIT<\/span><\/span>\n      ENDIF      <\/span><\/span>\n<\/span>\n      <\/span>SysWait<\/span>()<\/span><\/span>\n<\/span>\n      IF nCounter <\/span>==<\/span> <\/span>10<\/span><\/span>\n         EXIT<\/span><\/span>\n      ENDIF   <\/span><\/span>\n<\/span>\n   ENDDO<\/span><\/span>\n<\/span>\n   IF <\/span>!<\/span>lOk<\/span><\/span>\n      <\/span>MsgStop<\/span>(<\/span>"<\/span>Timeout! Try again<\/span>"<\/span>)<\/span><\/span>\n      RETURN NIL<\/span><\/span>\n   ENDIF<\/span><\/span>\n   <\/span><\/span>\n<\/span>\n   <\/span>AWait_SetValue<\/span>(<\/span> oWebView<\/span>,<\/span> <\/span>"<\/span>#login-username<\/span>"<\/span>,<\/span> <\/span>"<\/span>fivewin<\/span>"<\/span>)<\/span><\/span>\n   <\/span>AWait_Click<\/span>(<\/span> oWebView<\/span>,<\/span> <\/span>"<\/span>#login-signin<\/span>"<\/span> <\/span>)<\/span><\/span>\n<\/span>\nRETURN NIL   <\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
<\/div>\n\n\n\n
TAWaitWeb.prg<\/h2>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
<\/span>\n\/*<\/span><\/span>\n<\/span>\nTAWaitWeb.prg<\/span><\/span>\n<\/span>\nThis is a class for Fivewin TWebView that retrieves data from the WebView in Sync mode.<\/span><\/span>\nc)copyright 2023- charleskwonohjun@gmail.com ( Seoul, Korea )<\/span><\/span>\n<\/span>\n*\/<\/span><\/span>\n<\/span>\n#<\/span>include<\/span> <\/span>"<\/span>fivewin.ch<\/span>"<\/span><\/span>\n<\/span>\nFUNCTION <\/span>AWait_QuerySelector<\/span>(<\/span> oWeb<\/span>,<\/span> cQuery<\/span>,<\/span> nSecond <\/span>)<\/span><\/span>\n    LOCAL oFunc<\/span><\/span>\n    LOCAL cReturn :<\/span>=<\/span> <\/span>""<\/span><\/span>\n<\/span>\n    oFunc :<\/span>=<\/span> <\/span>TAWaitWeb<\/span>()<\/span>:<\/span>New<\/span>(<\/span> oWeb <\/span>)<\/span>    <\/span><\/span>\n    oFunc:<\/span>Query<\/span>(<\/span> cQuery<\/span>,<\/span> nSecond <\/span>)<\/span><\/span>\n<\/span>\n    cReturn :<\/span>=<\/span> oFunc:cReturn    <\/span><\/span>\n<\/span>\nRETURN cReturn <\/span><\/span>\n<\/span>\nFUNCTION <\/span>AWait_QuerySelectAll<\/span>(<\/span> oWeb<\/span>,<\/span> cQuery<\/span>,<\/span> nSecond <\/span>)<\/span><\/span>\n    LOCAL oFunc<\/span><\/span>\n    LOCAL cReturn :<\/span>=<\/span> <\/span>""<\/span><\/span>\n<\/span>\n    oFunc :<\/span>=<\/span> <\/span>TAWaitWeb<\/span>()<\/span>:<\/span>New<\/span>(<\/span> oWeb <\/span>)<\/span>    <\/span><\/span>\n    oFunc:<\/span>QuerySelectAll<\/span>(<\/span> cQuery<\/span>,<\/span> nSecond <\/span>)<\/span><\/span>\n<\/span>\n    cReturn :<\/span>=<\/span> oFunc:cReturn    <\/span><\/span>\n<\/span>\nRETURN cReturn <\/span><\/span>\n<\/span>\n<\/span>\nFUNCTION <\/span>AWait_GetOuterHTML<\/span>(<\/span> oWeb<\/span>,<\/span> cSelector<\/span>,<\/span> nSecond <\/span>)<\/span><\/span>\n    LOCAL oFunc<\/span><\/span>\n    LOCAL cReturn :<\/span>=<\/span> <\/span>""<\/span><\/span>\n<\/span>\n    oFunc :<\/span>=<\/span> <\/span>TAWaitWeb<\/span>()<\/span>:<\/span>New<\/span>(<\/span> oWeb <\/span>)<\/span><\/span>\n    oFunc:<\/span>getOuterHTML<\/span>(<\/span> cSelector<\/span>,<\/span> nSecond <\/span>)<\/span><\/span>\n<\/span>\n    cReturn :<\/span>=<\/span> oFunc:cReturn    <\/span><\/span>\n<\/span>\nRETURN cReturn <\/span><\/span>\n<\/span>\nFUNCTION <\/span>AWait_SetValue<\/span>(<\/span> oWeb<\/span>,<\/span> cSelector<\/span>,<\/span> cValue <\/span>)<\/span><\/span>\n    LOCAL oFunc<\/span><\/span>\n    <\/span><\/span>\n    oFunc :<\/span>=<\/span> <\/span>TAWaitWeb<\/span>()<\/span>:<\/span>New<\/span>(<\/span> oWeb <\/span>)<\/span><\/span>\n    oFunc:<\/span>SetValue<\/span>(<\/span> cSelector<\/span>,<\/span> cValue <\/span>)<\/span>    <\/span><\/span>\n<\/span>\nRETURN NIL<\/span><\/span>\n<\/span>\nFUNCTION <\/span>AWait_Click<\/span>(<\/span> oWeb<\/span>,<\/span> cSelector <\/span>)<\/span><\/span>\n    LOCAL oFunc<\/span><\/span>\n    <\/span><\/span>\n    oFunc :<\/span>=<\/span> <\/span>TAWaitWeb<\/span>()<\/span>:<\/span>New<\/span>(<\/span> oWeb <\/span>)<\/span><\/span>\n    oFunc:<\/span>Click<\/span>(<\/span> cSelector <\/span>)<\/span><\/span>\n<\/span>\nRETURN NIL<\/span><\/span>\n<\/span>\n<\/span>\nCLASS TAWaitWeb<\/span><\/span>\n<\/span>\n    DATA bOldBind<\/span><\/span>\n    DATA oWeb<\/span><\/span>\n    DATA cQuery<\/span><\/span>\n    DATA nSecond<\/span><\/span>\n<\/span>\n    DATA cReturn <\/span><\/span>\n<\/span>\n    METHOD <\/span>New<\/span>(<\/span> oWeb<\/span>,<\/span> cQuery<\/span>,<\/span> nSecond <\/span>)<\/span> CONSTRUCTOR <\/span><\/span>\n    METHOD <\/span>GetBind<\/span>(<\/span> cJson<\/span>,<\/span> cCalls<\/span>,<\/span> <\/span>...<\/span> <\/span>)<\/span><\/span>\n    METHOD <\/span>Query<\/span>(<\/span> cQuery<\/span>,<\/span> nSecond <\/span>)<\/span><\/span>\n    METHOD <\/span>QuerySelectAll<\/span>(<\/span> cQuery<\/span>,<\/span> nSecond <\/span>)<\/span><\/span>\n    <\/span><\/span>\n    METHOD <\/span>GetOuterHtml<\/span>(<\/span> cSelecter<\/span>,<\/span> nSecond <\/span>)<\/span><\/span>\n    METHOD <\/span>Eval<\/span>(<\/span> cEval <\/span>)<\/span><\/span>\n    METHOD <\/span>SetValue<\/span>(<\/span> cSelector<\/span>,<\/span> cValue <\/span>)<\/span><\/span>\n    METHOD <\/span>Click<\/span>(<\/span> cSelector <\/span>)<\/span><\/span>\n    <\/span><\/span>\nENDCLASS    <\/span><\/span>\n<\/span>\nMETHOD <\/span>New<\/span>(<\/span> oWeb <\/span>)<\/span> CLASS TAWaitWeb <\/span><\/span>\n<\/span>\n    ::oWeb :<\/span>=<\/span> oWeb<\/span><\/span>\n    ::oWeb:<\/span>Bind<\/span>(<\/span> <\/span>"<\/span>SendToFWH<\/span>"<\/span> <\/span>)<\/span>   <\/span><\/span>\n      <\/span><\/span>\nRETURN Self<\/span><\/span>\n<\/span>\nMETHOD <\/span>Query<\/span>(<\/span> cQuery<\/span>,<\/span> nSecond<\/span>,<\/span> cReturn <\/span>)<\/span> CLASS TAWaitWeb <\/span><\/span>\n    LOCAL nCounter :<\/span>=<\/span> <\/span>0<\/span><\/span>\n    LOCAL lReturn  :<\/span>=<\/span> .f.<\/span><\/span>\n    LOCAL cEval    :<\/span>=<\/span> <\/span>"<\/span>SendToFWH($QUERY$, 'WebFunc')<\/span>"<\/span><\/span>\n    LOCAL nStartSec :<\/span>=<\/span> <\/span>GetTickCount<\/span>()<\/span><\/span>\n<\/span>\n    DEFAULT nSecond :<\/span>=<\/span> <\/span>500<\/span><\/span>\n    <\/span><\/span>\n    ::bOldBind :<\/span>=<\/span> ::oWeb:bOnBind<\/span><\/span>\n    ::oWeb:bOnBind :<\/span>=<\/span> <\/span>{<\/span> <\/span>|<\/span> cJson<\/span>,<\/span> cCalls<\/span>,<\/span> ... <\/span>|<\/span> <\/span>::GetBind<\/span>(<\/span> cJson<\/span>,<\/span> cCalls<\/span>,<\/span> ... <\/span>)<\/span> <\/span>}<\/span><\/span>\n<\/span>\n    cEval :<\/span>=<\/span> <\/span>STRTRAN<\/span>(<\/span> cEval<\/span>,<\/span> <\/span>"<\/span>$QUERY$<\/span>"<\/span>,<\/span> cQuery <\/span>)<\/span> <\/span><\/span>\n   <\/span><\/span>\n    ::cReturn :<\/span>=<\/span> <\/span>""<\/span><\/span>\n<\/span>\n    WHILE .T.<\/span><\/span>\n        ::oWeb:<\/span>Eval<\/span>(<\/span> cEval <\/span>)<\/span><\/span>\n<\/span>\n        <\/span>sleep<\/span>(<\/span>100<\/span>)<\/span><\/span>\n        <\/span>SysWait<\/span>()<\/span><\/span>\n       <\/span><\/span>\n        IF <\/span>!<\/span>EMPTY<\/span>(<\/span> ::cReturn <\/span>)<\/span><\/span>\n            lReturn :<\/span>=<\/span> .t.<\/span><\/span>\n            EXIT<\/span><\/span>\n        ENDIF    <\/span><\/span>\n<\/span>\n        IF <\/span>GetTickCount<\/span>()<\/span> <\/span>-<\/span> nStartSec  <\/span>>=<\/span> nSecond<\/span><\/span>\n           EXIT<\/span><\/span>\n        ENDIF<\/span><\/span>\n    ENDDO   <\/span><\/span>\n<\/span>\n    cReturn :<\/span>=<\/span> ::cReturn<\/span><\/span>\n<\/span>\n    ::oWeb:bOnBind :<\/span>=<\/span> ::bOldBind<\/span><\/span>\n<\/span>\nRETURN lReturn<\/span><\/span>\n<\/span>\nMETHOD <\/span>QuerySelectAll<\/span>(<\/span> cQuery<\/span>,<\/span> nSecond<\/span>,<\/span> cReturn <\/span>)<\/span> CLASS TAWaitWeb <\/span><\/span>\n    LOCAL nCounter :<\/span>=<\/span> <\/span>0<\/span><\/span>\n    LOCAL lReturn  :<\/span>=<\/span> .f.<\/span><\/span>\n    LOCAL cEval    :<\/span>=<\/span> <\/span>"<\/span>SendToFWH(querySelectorAll($QUERY$), 'WebFunc')<\/span>"<\/span><\/span>\n    LOCAL nStartSec :<\/span>=<\/span> <\/span>GetTickCount<\/span>()<\/span><\/span>\n<\/span>\n    DEFAULT nSecond :<\/span>=<\/span> <\/span>500<\/span><\/span>\n    <\/span><\/span>\n    ::bOldBind :<\/span>=<\/span> ::oWeb:bOnBind<\/span><\/span>\n    ::oWeb:bOnBind :<\/span>=<\/span> <\/span>{<\/span> <\/span>|<\/span> cJson<\/span>,<\/span> cCalls<\/span>,<\/span> ... <\/span>|<\/span> <\/span>::GetBind<\/span>(<\/span> cJson<\/span>,<\/span> cCalls<\/span>,<\/span> ... <\/span>)<\/span> <\/span>}<\/span><\/span>\n<\/span>\n    cEval :<\/span>=<\/span> <\/span>STRTRAN<\/span>(<\/span> cEval<\/span>,<\/span> <\/span>"<\/span>$QUERY$<\/span>"<\/span>,<\/span> cQuery <\/span>)<\/span> <\/span><\/span>\n   <\/span><\/span>\n    ::cReturn :<\/span>=<\/span> <\/span>""<\/span><\/span>\n<\/span>\n    WHILE .T.<\/span><\/span>\n        ::oWeb:<\/span>Eval<\/span>(<\/span> cEval <\/span>)<\/span><\/span>\n<\/span>\n        <\/span>sleep<\/span>(<\/span>100<\/span>)<\/span><\/span>\n        <\/span>SysWait<\/span>()<\/span><\/span>\n       <\/span><\/span>\n        IF <\/span>!<\/span>EMPTY<\/span>(<\/span> ::cReturn <\/span>)<\/span><\/span>\n           lReturn :<\/span>=<\/span> .t.<\/span><\/span>\n           EXIT<\/span><\/span>\n        ENDIF    <\/span><\/span>\n<\/span>\n        IF <\/span>GetTickCount<\/span>()<\/span> <\/span>-<\/span> nStartSec  <\/span>>=<\/span> nSecond<\/span><\/span>\n           EXIT<\/span><\/span>\n        ENDIF    <\/span><\/span>\n    ENDDO   <\/span><\/span>\n<\/span>\n    cReturn :<\/span>=<\/span> ::cReturn<\/span><\/span>\n<\/span>\n    ::oWeb:bOnBind :<\/span>=<\/span> ::bOldBind<\/span><\/span>\n    <\/span><\/span>\nRETURN lReturn<\/span><\/span>\n<\/span>\n<\/span>\nMETHOD <\/span>GetOuterHtml<\/span>(<\/span> cSelecter<\/span>,<\/span> nSecond <\/span>)<\/span> CLASS TAWaitWeb <\/span><\/span>\n    LOCAL cQuery :<\/span>=<\/span> <\/span>"<\/span>SendToFWH( document.querySelector('$SELECTER$').outerHTML, 'savehtml')<\/span>"<\/span><\/span>\n    LOCAL cEval<\/span><\/span>\n    LOCAL nStartSec :<\/span>=<\/span> <\/span>GetTickCount<\/span>()<\/span><\/span>\n    LOCAL lReturn  :<\/span>=<\/span> .f.<\/span><\/span>\n<\/span>\n    DEFAULT nSecond :<\/span>=<\/span> <\/span>500<\/span><\/span>\n<\/span>\n    ::bOldBind :<\/span>=<\/span> ::oWeb:bOnBind<\/span><\/span>\n    ::oWeb:bOnBind :<\/span>=<\/span> <\/span>{<\/span> <\/span>|<\/span> cJson<\/span>,<\/span> cCalls<\/span>,<\/span> ... <\/span>|<\/span> <\/span>::GetBind<\/span>(<\/span> cJson<\/span>,<\/span> cCalls<\/span>,<\/span> ... <\/span>)<\/span> <\/span>}<\/span><\/span>\n<\/span>\n    cEval :<\/span>=<\/span> <\/span>STRTRAN<\/span>(<\/span> cQuery <\/span>,<\/span> <\/span>"<\/span>$SELECTER$<\/span>"<\/span>,<\/span> cSelecter <\/span>)<\/span><\/span>\n    <\/span><\/span>\n    ::cReturn :<\/span>=<\/span> <\/span>""<\/span><\/span>\n<\/span>\n    WHILE .T.<\/span><\/span>\n        ::oWeb:<\/span>Eval<\/span>(<\/span> cEval <\/span>)<\/span><\/span>\n<\/span>\n        <\/span>sleep<\/span>(<\/span>100<\/span>)<\/span><\/span>\n        <\/span>SysWait<\/span>()<\/span>        <\/span><\/span>\n<\/span>\n        IF <\/span>!<\/span>EMPTY<\/span>(<\/span> ::cReturn <\/span>)<\/span><\/span>\n           lReturn :<\/span>=<\/span> .t.<\/span><\/span>\n           EXIT<\/span><\/span>\n        ENDIF    <\/span><\/span>\n<\/span>\n        IF <\/span>GetTickCount<\/span>()<\/span> <\/span>-<\/span> nStartSec  <\/span>>=<\/span> nSecond<\/span><\/span>\n           EXIT<\/span><\/span>\n        ENDIF  <\/span><\/span>\n    ENDDO      <\/span><\/span>\n        <\/span><\/span>\n    ::oWeb:bOnBind :<\/span>=<\/span> ::bOldBind<\/span><\/span>\n    <\/span><\/span>\nRETURN lReturn<\/span><\/span>\n<\/span>\n<\/span>\nMETHOD <\/span>GetBind<\/span>(<\/span> cJson<\/span>,<\/span> cCalls<\/span>,<\/span> <\/span>...<\/span> <\/span>)<\/span> CLASS TAWaitWeb <\/span><\/span>\n    LOCAL hResponse :<\/span>=<\/span> <\/span>hash<\/span>()<\/span><\/span>\n    <\/span><\/span>\n    <\/span>hb_jsondecode<\/span>(<\/span>cJson <\/span>,<\/span>@hResponse <\/span>)<\/span><\/span>\n    <\/span><\/span>\n    ::cReturn :<\/span>=<\/span> <\/span>""<\/span><\/span>\n<\/span>\n    IF <\/span>LEN<\/span>(<\/span> hResponse <\/span>)<\/span> <\/span>>=<\/span> <\/span>1<\/span><\/span>\n       ::cReturn :<\/span>=<\/span> hResponse<\/span>[<\/span>1<\/span>]<\/span>     <\/span><\/span>\n    ENDIF   <\/span><\/span>\n<\/span>\nRETURN NIL<\/span><\/span>\n<\/span>\n<\/span>\nMETHOD <\/span>Eval<\/span>(<\/span> cEval <\/span>)<\/span> CLASS TAWaitWeb <\/span><\/span>\n<\/span>\n    ::oWeb:<\/span>Eval<\/span>(<\/span> cEval <\/span>)<\/span><\/span>\n<\/span>\nRETURN NIL<\/span><\/span>\n<\/span>\nMETHOD <\/span>SetValue<\/span>(<\/span> cSelector<\/span>,<\/span> cValue <\/span>)<\/span> CLASS TAWaitWeb <\/span><\/span>\n    LOCAL cEval :<\/span>=<\/span> <\/span>""<\/span><\/span>\n<\/span>\n    cEval :<\/span>=<\/span> <\/span>"<\/span>document.querySelector('$SELECTOR$').value = '$VALUE$'<\/span>"<\/span><\/span>\n    cEval :<\/span>=<\/span> <\/span>STRTRAN<\/span>(<\/span> cEval<\/span>,<\/span> <\/span>"<\/span>$SELECTOR$<\/span>"<\/span>,<\/span> cSelector <\/span>)<\/span><\/span>\n    cEval :<\/span>=<\/span> <\/span>STRTRAN<\/span>(<\/span> cEval<\/span>,<\/span> <\/span>"<\/span>$VALUE$<\/span>"<\/span>,<\/span> cValue <\/span>)<\/span>    <\/span><\/span>\n    <\/span><\/span>\n    ::<\/span>Eval<\/span>(<\/span> cEval <\/span>)<\/span><\/span>\n<\/span>\nRETURN NIL<\/span><\/span>\n<\/span>\nMETHOD <\/span>Click<\/span>(<\/span> cSelector <\/span>)<\/span> CLASS TAWaitWeb <\/span><\/span>\n    LOCAL cEval :<\/span>=<\/span> <\/span>""<\/span><\/span>\n<\/span>\n    cEval :<\/span>=<\/span> <\/span>"<\/span>document.querySelector('$SELECTOR$').click()<\/span>"<\/span><\/span>\n    cEval :<\/span>=<\/span> <\/span>STRTRAN<\/span>(<\/span> cEval<\/span>,<\/span> <\/span>"<\/span>$SELECTOR$<\/span>"<\/span>,<\/span> cSelector <\/span>)<\/span><\/span>\n    <\/span><\/span>\n    <\/span><\/span>\n    ::<\/span>Eval<\/span>(<\/span> cEval <\/span>)<\/span><\/span>\n<\/span>\nRETURN NIL<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
<\/p>\n\n\n\n
Manual<\/h2>\n\n\n\n
<\/p>\n\n\n\n

Introduction<\/p>\n\n\n\n
TAWaitWeb is a class designed for interacting with web elements within a TWebView control in a synchronous manner. It facilitates actions like querying, clicking, and modifying values of web elements. This manual provides an in-depth explanation of the class structure, methods, and their usage.<\/p>\n\n\n\n
Class Definition
Class Name: TAWaitWeb
Class Purpose
The TAWaitWeb class enables developers to perform various actions on web elements within a TWebView control. It encapsulates JavaScript evaluations to ensure synchronous behavior and provides methods for different interactions with web elements.<\/p>\n\n\n\n
Class Members
DATA bOldBind: A member variable to store the previous state of the binding status of the TWebView control.
DATA oWeb: A member variable to hold the TWebView control instance.
DATA cQuery: A member variable to store the query used for web element selection.
DATA nSecond: A member variable to define a timeout in milliseconds for waiting.
DATA cReturn: A member variable to store the response or result of actions performed within the class.

Constructor Method
Method Name: New( oWeb )<\/strong>
Purpose: Initializes an instance of the TAWaitWeb class.<\/p>\n\n\n\n
Parameters:<\/p>\n\n\n\n
oWeb: The TWebView control instance to be used for interactions.
Usage:<\/p>\n\n\n\n
Action Methods
Method Name: Query( cQuery, nSecond )<\/strong>
Purpose: Performs a query on a web element using the provided selector and waits for a response.<\/p>\n\n\n\n
Parameters:<\/p>\n\n\n\n
cQuery: The CSS selector for the web element to be queried.
nSecond: (Optional) The timeout in milliseconds for waiting.

Method Name: QuerySelectAll( cQuery, nSecond )<\/strong>
Purpose: Performs a query to select multiple web elements using the provided selector and waits for a response.<\/p>\n\n\n\n
Parameters:<\/p>\n\n\n\n
cQuery: The CSS selector for the web elements to be queried.
nSecond: (Optional) The timeout in milliseconds for waiting.<\/p>\n\n\n\n
Method Name: GetOuterHtml( cSelector, nSecond )<\/strong>
Purpose: Retrieves the outer HTML of a web element using the provided selector and waits for a response.<\/p>\n\n\n\n
Parameters:<\/p>\n\n\n\n
cSelector: The CSS selector for the web element.
nSecond: (Optional) The timeout in milliseconds for waiting.<\/p>\n\n\n\n
Method Name: SetValue( cSelector, cValue )<\/strong>
Purpose: Sets a value on a specific web element using the provided selector.<\/p>\n\n\n\n
Parameters:<\/p>\n\n\n\n
cSelector: The CSS selector for the web element.
cValue: The value to be set on the web element.<\/p>\n\n\n\n
Method Name: Click( cSelector )<\/strong>
Purpose: Simulates a click action on a specific web element using the provided selector.<\/p>\n\n\n\n
Parameters:<\/p>\n\n\n\n
cSelector: The CSS selector for the web element to be clicked.<\/p>\n\n\n\n
Utility Methods
Method Name: GetBind( cJson, cCalls, \u2026 )<\/strong>
Purpose: Decodes JSON responses and sets the cReturn member variable.<\/p>\n\n\n\n
Parameters:<\/p>\n\n\n\n
cJson: The JSON response to be decoded.
cCalls: Additional parameters.
Usage: This method is used internally by other methods and doesn’t require direct user interaction.<\/p>\n\n\n\n
Method Name: Eval( cEval )<\/strong>
Purpose: Evaluates JavaScript code within the TWebView control.<\/p>\n\n\n\n
Parameters:<\/p>\n\n\n\n
cEval: The JavaScript code to be evaluated.
Usage: This method is used internally by other methods and doesn’t require direct user interaction.<\/p>\n\n\n\n
Conclusion<\/strong>
The TAWaitWeb class offers a comprehensive way to interact with web elements within a TWebView control using various action methods. Developers can use this class to perform queries, clicks, and value modifications on web elements, ensuring synchronous behavior. By following the provided usage examples, developers can easily integrate the TAWaitWeb class into their FiveWin projects and enhance their interactions with web elements.<\/p>\n\n\n\n
<\/p>\n\n\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
Using the DOM allows you to access a website and automatically log in.It can also automatically insert values…<\/p>\n","protected":false},"author":1,"featured_media":936,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_kadence_starter_templates_imported_post":true,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"categories":[4],"tags":[],"class_list":["post-935","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-technique-productivity"],"taxonomy_info":{"category":[{"value":4,"label":"Technique"}]},"featured_image_src_large":["https:\/\/www.charleskwon.com\/wp-content\/uploads\/2023\/08\/image-6.png",798,903,false],"author_info":{"display_name":"CharlesKWON","author_link":"https:\/\/www.charleskwon.com\/?author=1"},"comment_info":0,"category_info":[{"term_id":4,"name":"Technique","slug":"technique-productivity","term_group":0,"term_taxonomy_id":4,"taxonomy":"category","description":"","parent":0,"count":8,"filter":"raw","cat_ID":4,"category_count":8,"category_description":"","cat_name":"Technique","category_nicename":"technique-productivity","category_parent":0}],"tag_info":false,"_links":{"self":[{"href":"https:\/\/www.charleskwon.com\/index.php?rest_route=\/wp\/v2\/posts\/935","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.charleskwon.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.charleskwon.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.charleskwon.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.charleskwon.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=935"}],"version-history":[{"count":4,"href":"https:\/\/www.charleskwon.com\/index.php?rest_route=\/wp\/v2\/posts\/935\/revisions"}],"predecessor-version":[{"id":946,"href":"https:\/\/www.charleskwon.com\/index.php?rest_route=\/wp\/v2\/posts\/935\/revisions\/946"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.charleskwon.com\/index.php?rest_route=\/wp\/v2\/media\/936"}],"wp:attachment":[{"href":"https:\/\/www.charleskwon.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=935"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.charleskwon.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=935"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.charleskwon.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=935"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}