Locals Panel

To view the panel, do one of the following:

• Choose View > Debug > Locals from the TestComplete main menu.

• Choose View > Select Panel from the TestComplete main menu and choose Locals in the ensuing Select Panel dialog.

During the test execution, TestComplete automatically fills the panel with variable and parameter names, values and type information. If the test engine is running a keyword test, the panel displays variables defined in this test and parameters of the test. If the test engine is running a script routine, the panel displays information about script variables and parameters passed to the current script routine.

Each row in the panel corresponds to a variable or parameter. The panel contains three columns: Name, Value and Type. They display the variables’ (or parameters’) names, values and data type correspondingly.

If a variable (or parameter) stores a reference to an object, the row has a plus button and the Value column displays [Object].

If a variable (or parameter) stores a reference to an array, the row also has a plus button and the Value column displays {...}.

Note:

If the lists and arrays listed below contain too many items, the Locals panel groups them by 100 for convenient presentation: JavaScript arrays and typed arrays Python tuples and lists VBScript arrays returned from COM objects (SAFEARRAY objects)

When stepping through tests, value changes since the previous step are highlighted to help you track the changes.

You can customize columns of the panel using customization capabilities provided by TestComplete. You can also dock and undock the Locals panel as you would do with all other TestComplete panels.

Collapsing and Expanding Object Properties Trees

Inspecting Variables

Adding Variables to the Watch List

Local vs Global Variables

Script variables can be local or global:

• Local variables are declared inside a function, and exist only within that function.

• Global variables are declared on the script level, usually outside of all functions and at the beginning of the script. Global variables can be used in all functions in this script.

Examples

ExamplesExamples

In JavaScript, all variables declared without the var or let keyword are automatically global.

In JScript, C#Script, and C++Script, all variables declared without the var keyword are automatically global.

In Python, all variables used inside a function are local, unless they have been declared with the global keyword.

JavaScript

JScript

Python

VBScript

DelphiScript

C++Script, C#Script

JavaScript

var global1 = "I'm global";
let global2 = "And I'm global";
global3 = "I'm also global";

function Test()
{
  var local = "I'm local";

  global4 = "I'm global"; // because declared without the "var" keyword
}

JScript

var global = "I'm global";
global2 = "I'm also global";

function Test()
{
  var local = "I'm local";

  global3 = "I'm global"; // because declared without the "var" keyword
}

Python

globalVar = "I'm global"
myVar = "I'm also global"

def Test():
  global globalVar
  globalVar = "I'm still global"

  localVar = "I'm local"
  myVar = "I'm also local" # Local variable with the same name as a global variable

VBScript

Dim global
global = "I'm global"

global2 = "I'm also global"

Sub Test
  Dim local
  local = "I'm local"

  local2 = "I'm also local"
End Sub

DelphiScript

var global;

procedure Test;
var local;
begin
  global := 'I am global';
  local := 'I am local';
end;

C++Script, C#Script

var global = "I'm global";
global2 = "I'm also global";

function Test()
{
  var local = "I'm local";

  global3 = "I'm global"; // because declared without the "var" keyword
}

The Locals panel, as the name suggests, shows only local script variables. To see the values of global variables, you can:

• Use the Evaluate dialog (Ctrl+F12).

• Add global variables to the Watch List.