Applies to TestComplete 12.40, last modified on October 6, 2017

Each TestComplete project uses one of the supported scripting languages:

  • JavaScript

  • JScript

  • Python

  • VBScript

  • DelphiScript

  • C#Script

  • C++Script

The scripting language for the project is specified at the project creation time and cannot be changed later (see Create New Project Wizard - Project Scripting Language Page ).

The scripting language is important even if you are not going to create test scripts. The scripting language also defines the syntax of script code snippets that you can use in keyword tests. Also, the scripting language defines the syntax of test object names in your tests. For instance, in JavaScript, JScript, Python and VBScript, the name of the Notepad process looks like Process("Notepad"). In DelphiScript, you should replace quotes with apostrophes: Process('Notepad'); and in C#Script and C++Script, the word Process should be enclosed in brackets: ["Process"]("Notepad").

Which language to choose?

The supported languages are quite different, so you may ask “Which one should I choose for my project?” The answer is simple: choose the language you know better and that is closer to your development experience. This will decrease the test creation time, since you will not have to learn a new language. The rest of this topic contains answers to some typical questions that users ask when selecting a scripting language.

Should the scripting language match the language of my tested application?

No, a project’s scripting language does not depend on your tested application’s programming language. For instance, you can use JScript to test Visual C++ applications, or VBScript to test Delphi programs. There is only one recommendation: if you plan to create a Connected or a Self-Testing Application, you should select the scripting language that matches the development tool where you will create that application. That is, if you use Visual C++ or C++Builder, you should select C++Script; if you use Visual Basic, select VBScript; if you use C#, use C#Script, and if you use Delphi, select DelphiScript. This will make it easier to import recorded scripts to Connected and Self-Testing Applications.

Will my project be limited in functionality if I select this or that language?

No, it will not. The vast majority of TestComplete features is equally oriented on each of the supported languages. So, you can choose the language that is closer to your developer skills.

Note however that the syntax of C#Script and C++Script differs from that of C# and C++. So, selecting these scripting languages makes sense only if you plan to create a Connected or Self-Testing C++ or C# application. If you want to select C#Script or C++Script only due to that the C# or C++ syntax is closer to your skills, we recommend that you rather use JavaScript as its syntax is more similar to C# and C++ than the C#Script and C++Script syntax is.

Scripting languages have a different set of predefined functions. Why do you say the project will not be limited in functionality?

Yes, each scripting language provides a number of built-in functions that help you perform some routine actions, such as converting numerical values to strings and vice versa (C#Script and C++Script have the same functions as JScript, since these languages are based on JScript). Normally, the sets of predefined functions of different scripting languages are similar to each other, with few exceptions (for instance, DelphiScript does not have an analogue of VBScript’s split function). However, the difference in predefined functions is negligible, since most of predefined functions are simple and you can easily create their analogues in another language. Also, TestComplete provides an extensive set of scripting objects whose functionality covers the functionality of predefined functions. They can be used in any project, regardless of its scripting language.

What are the specifics of the supported scripting languages that may affect my tests?

As we have said above, you will not be limited in functionality if you prefer one language to another - you will be able to use all of TestComplete features regardless of which language you choose. However, due to the fact that languages have different syntax and work via different engines, there are few exceptions:

  • JavaScript, JScript and Python do not support functions that obtain parameters by reference. The same applies to C#Script and C++Script since these languages work via the JScript engine.

  • Any of the supported scripting languages let you call routines and variables defined in another unit. However, circular references between units are supported in JavaScript, Python, VBScript and DelphiScript only and are not supported in JScript, C#Script and C++Script.

  • Some users consider that exception handling in JavaScript, JScript, Python, DelphiScript, C#Script or C++Script may be more convenient than exception handling in VBScript.

  • The format of arrays in JavaScript, JScript, Python, C#Script and C++Script differs from the DelphiScript and VBScript (see Supported Scripting Languages - Specifics of Usage). This affects the usage of some routines (for example, the AddNamedChild method) in JScript, C#Script and C++Script code. For more information, see documentation for the specific method.

For more information on usage specifics of supported scripting languages, see Supported Scripting Languages - Specifics of Usage.

See Also

Script Tests
Supported Scripting Languages - Specifics of Usage
Creating Projects and Project Suites
Create New Project Wizard - Project Scripting Language Page
Create Project Dialog