Run JavaScript on Web Pages

Call application-defined script functions directly by their name via the contentDocument.Script object and the dot notation (in VBScript, JScript, Python and DelphiScript) or bracket notation (in C++Script and C#Script):

For example, if a web page contains the following function:

you can call this function from your test as follows:

To run custom JavaScript code on a web page, you can use the following syntax:

The eval approach is useful for calling:

• DOM methods, such as history.back(), location.reload(), window.alert() and so on:

  JavaScript, JScript

  Python

  VBScript

  DelphiScript

  C++Script, C#Script

  Copy Code

  JavaScript, JScript

  pageObj.contentDocument.Script.eval("history.back()");

  Python

  pageObj.contentDocument.Script.eval("history.back()");

  VBScript

  pageObj.contentDocument.Script.eval("history.back()")

  DelphiScript

  pageObj.contentDocument.Script.eval('history.back()');

  C++Script, C#Script

  pageObj["contentDocument"]["Script"]["eval"]("history.back()");

• arbitrary JavaScript expressions:

  JavaScript, JScript

  Python

  VBScript

  DelphiScript

  C++Script, C#Script

  Copy Code

  JavaScript, JScript

  pageObj.contentDocument.Script.eval("var i = 5; alert(i);");

  Python

  pageObj.contentDocument.Script.eval("var i = 5; alert(i);");

  VBScript

  pageObj.contentDocument.Script.eval("var i = 5; alert(i);")

  DelphiScript

  pageObj.contentDocument.Script.eval('var i = 5; alert(i);');

  C++Script, C#Script

  pageObj["contentDocument"]["Script"]["eval"]("var i = 5; alert(i);");

In Chrome and Edge Chromium, to call a function defined on a web page frame, use the following syntax:

To execute arbitrary JavaScript code inside a frame using eval, use the following syntax with the frame ID and double eval:

VBScript and DelphiScript let you omit parentheses when calling procedures and functions that do not take any parameters. However, when calling parameterless functions on web pages, do not omit parentheses:

This is because the syntax without parentheses does not execute the specified function. Instead, it returns the JavaScript Function object corresponding to this function.

Note: In cross-platform web tests, you can only call functions that return simple type data (strings, integers, and Booleans).

The VBScript, Python and DelphiScript array format is incompatible with the JavaScript array format. As a result, you cannot directly pass arrays between your VBScript or DelphiScript tests and JavaScript scripts on web pages; you should use a specific approach for this.

To pass an array as a parameter to a web page’s JavaScript function, call this function using eval (see above). In this way, you can specify the array elements using JavaScript's array literal syntax [elem1, elem2, ..., elemN].

# Converts a JavaScript array to a DelphiScript-compatible array
def JSArrayToVariantArray(JSArray):
  arr = BuiltIn.CreateVariantArray(0, JSArray.length - 1);

  for i in range (0, JSArray.length - 1):
    arr[i] = aqObject.GetPropertyValue(JSArray, i);
  return arr;

You can use the JSArrayToVariantArray function as follows:

The array obtained in this way is compatible with VBScript, Python and DelphiScript and can be processed using native array operations and functions of these scripting languages. For example, in VBScript you can use the LBound and UBound functions to determine the array’s lower and upper bounds and access array elements using the parenthesis syntax: arr(index).

JavaScript supports using callback functions, that is, passing functions as arguments to other functions. For example:

To call such functions from your test and specify a callback function, use eval (see above):

When working with JScript objects and properties from a VBScript project, you may get the Object doesn’t support this property or method runtime error message. The problem occurs when you assign a value of an object’s property to the variable, and the variable name coincides with the property name but differs by case (for example, name and Name).

Suppose we have a JScript object, Obj, with a property, propertyName. Note that the property name is case-sensitive, that is:

We want to get the property value to the PropertyName variable:

Due to VBScript specifics, if the property name coincides with the variable name, the scripting engine passes the variable name (instead of the property name) to the object. In other words, instead of getting the propertyName property, the code above will try to get the PropertyName property (which does not exist). That is why this code throws an error.

To avoid such issues, do not specify variable names that coincide with property names. The following code will work correctly: