![]()
![]()
Web pages may contain VBScript or JScript functions that perform certain actions. For example, a script function may be called upon pressing a button or clicking a hyperlink on a tested page. Sometimes it is necessary to call scripts that are located in the tested web pages from TestComplete script routines. You can call a web page script using the following syntax:
- Internet Explorer or WebBrowser control:
DOM model:
Page(page_URL).document.Script.routine_name( [Parameter1, Parameter2, ...] )
Tree or Tag model:
Page(page_URL).Application.document.Script.routine_name( [Parameter1, Parameter2, ...] )
- Firefox:
DOM model:
Page(page_URL).document.Script.routine_name( [Parameter1, Parameter2, ...] )
Tree or Tag model:
Page(page_URL).contentDocument.Script.routine_name( [Parameter1, Parameter2, ...] )
| Note: | If you use the Hybrid model, you can call scripts using both the DOM and Tree model syntax. |
![]() | In DelphiScript, it is possible to call scripts located on web pages only if the Tree, Tag or Hybrid model is active. This functionality is not supported when using the DOM model. |
Suppose that the tested web page holds the following HTML fragment:
To call the MyFunc function from TestComplete, you can access this function through the Script property of the document object. The following code demonstrates this.
![]()
Show Example
![]()
Show Example![]()
Hide Example This sample script works with Internet Explorer 6. If you another browser, you will need to modify the script lines responsible for obtaining the Page and document objects. See Access to Web Pages and Web Page Elements and Working With Web Page Elements.
Sub Test
Dim p, w, Page
' Obtaining the browser process, window and the Page object
Set p = Sys.Process("iexplore")
Set w = p.IEFrame(0).Window("Shell DocObject View").Window("Internet Explorer_Server")
Set Page = w.Page("*")
' Calling the MyFunc function and passing parameters to it
' Determining the web tree model
If Options.Web.TreeModel = "DOM" Then
' If you use the DOM model...
Page.document.Script.MyFunc "String parameter", 1234
Else
' If you use other models...
Page.Application.Document.Script.MyFunc "String parameter", 1234
End If
End Sub
function Test()
{
var p, w, Page;
// Obtaining the browser process, window and the Page object
p = Sys.Process("iexplore");
w = p.IEFrame(0).Window("Shell DocObject View").Window("Internet Explorer_Server");
Page = w.Page("*");
// Calling the MyFunc function and passing parameters to it
// Determining the web tree model
if (Options.Web.TreeModel == "DOM")
{
// If you use DOM model...
Page.document.Script.MyFunc("String parameter", 1234);
}
else
{
// If you use other models...
Page.Application.Document.Script.MyFunc("String parameter", 1234);
}
}
procedure Test;
var p, w, Page: OleVariant;
begin
// Obtaining the browser process, window and the Page object
p := Sys.Process('iexplore');
w := p.IEFrame(0).Window('Shell DocObject View').Window('Internet Explorer_Server');
Page := w.Page('*');
// Calling the MyFunc function and passing parameters to it
// Determining the web tree model
if Options.Web.TreeModel <> 'DOM' then
// If you use any model but DOM...
Page.Application.Document.Script.MyFunc('String parameter', 1234)
else
// If you use the DOM model...
Log.Error('Cannot call a web page script because the DOM model is active.');
end;
function Test()
{
var p, w, Page;
// Obtaining the browser process, window and the Page object
p = Sys["Process"]("iexplore");
w = p["IEFrame"](0)["Window"]("Shell DocObject View")["Window"]("Internet Explorer_Server");
Page = w["Page"]("*");
// Calling the MyFunc function and passing parameters to it
// Determining the web tree model
if (Options.["Web"]["TreeModel"] == "DOM")
{
// If you use DOM model...
Page["document"]["Script"]["MyFunc"]("String parameter", 1234);
}
else
{
// If you use other models...
Page["Application"]["Document"]["Script"]["MyFunc"]("String parameter", 1234);
}
}
There is no relationship between the scripting language of the function located in a web page and the scripting language you use in TestComplete. As you can see, in our example we used a TestComplete VBScript routine to call a JScript function located on the tested web page.
Note that no parameter preparations are needed, because scripts on web pages and in TestComplete are OLE compatible. The only problem you may encounter are arrays. The point is that different scripting languages use different array models. The array model of a web script is compatible with the model implemented in VBScript, but it is not compatible with JScript, C++Script and C#Script (C++Script and C#Script are based on JScript and, therefore, they use the same array model). If you pass, for example, a VBScript array created in a TestComplete routine to a JScript function located on a web page, an error may occur. To solve the problem, you can use JScript’s VBArray object. For more information on this, please see MSDN (the on-line version is available at http://msdn.microsoft.com).
Web pages may not hold scripts directly, but they can load them from a file that is specified as a script source. That is, a web page may hold the following HTML code:
TestComplete still has access to scripts located in the script source file (in our example, it has access to scripts located in MyScriptFile.js). You can call these scripts from TestComplete routines in the same manner that was described above.
