Adds a filter for URL requests.

Arguments

filters. Filter representing one or more URLs (string). Separate multiple URLs with a semi-colon (;). The URL can have the wildcard (*) which can match 0 or more characters.

include. True to include URL requests that match the filter; otherwise false (default). Optional argument (boolean).

applyTo. (Optional argument) Specify the type of request the filter applies to:

• Xhr. Filters XHR requests only.

• NonXhr. Filters non-XHR requests only.

• All. Filters all requests (default).

Return value (void)

undefined

Example:

From the point that you add this API call, until you call the remove filter or the end of the iteration, TruClient will not wait for requests to get a response unless the URL has a http://www.myco.com/ prefix.

Back to top

Removes all URL request filters.

Arguments

None

Return value (void)

undefined

Example

None

Back to top

Starts logging URL requests.

Arguments

None

Return value (void)

undefined

Example

None

Back to top

Stops logging URL requests.

Arguments

None

Return value (void)

undefined

Example

None

Back to top

Advances the specified parameter to the next value in the file. This must be a parameter of type file or unique number; this is the argument type set in VuGen.

Arguments

name. The name of the parameter to advance (string).

Return value (void)

undefined

Example

Back to top

Returns the IP address when IP spoofing is enabled and the script is running in load mode in Controller.

Arguments

None

Return value (string)

Returns the IP address when IP spoofing is enabled and the script is running in load mode in Controller.

Example

None

Back to top

Saves a string to a parameter, creating a temporary parameter value in the memory if it does not exist (it does not create a parameter that can be read in the next run).

Arguments

name. The name of the parameter in which to save the value (string).

value. The parameter value (string).

Return value (void)

undefined

Example

TC.setParam("myparam", "paramVal");

Back to top

Begins a transaction in a Vuser script that will be ended in another Vuser script.

Arguments

name. The name of the transaction (string).

identifier. The identifier of the transaction (string). The same value is used by TC.crossTransactionEnd(name, identifier, type) to identify the transaction.

Return value (void)

undefined

Example

None

Back to top

Same as TC.log at the Standard log level with the additional ability to show the message in the Controller's Output window as a notification.

Arguments

text. The message text (string).

Return value (void)

undefined

Example

Back to top

Ends a transaction in a Vuser script that has been started in another Vuser script.

Arguments

name. The name of the transaction (string).

identifier. The identifier of the transaction (string). The value of the parameter must be identical to the value of the identifier param that the Vuser initiating the transaction used in TC.crossTransactionStart(name, identifier).

type. One of the following: "Pass", "Fail", "Auto", "Abort", or "Stop".

Return value (void)

undefined

Example

None

Back to top

Returns the duration of a specific transaction, in seconds.

Arguments

name. The name of the transaction (string).

Return value (string)

Returns the duration of a specific transaction, in seconds.

Example

None

Back to top

Returns the value of the specified parameter.

Arguments

name. The parameter name (string).

Return value (string)

Returns the value of the specified parameter.

Example

Back to top

Runs a specific function in C language, defined in the C-functions.c file.

Arguments

funcname. The function name (string).

functimeout. The maximum expected runtime, in seconds, of the function called by the step (number).

Return value (void)

undefined

Example

Back to top

Logs a message as a line in TruClient ’s interactive/load log.

Arguments

text. The message (string).

level. Optional argument. One of the following:

• "Error"
• "Warning"
• "Standard" (default)
• "Extended"
• "Status" - sends a string to the Status area of the Controller. It also sends the string to the Vuser log. When run from VuGen, the message is sent to output.txt.
• "Status_msg"

Return value (void)

undefined

Example

Back to top

Returns the text after unmasking.

Arguments

text. The masked text (string).

Return value (string)

Returns the text after unmasking.

Example

Back to top

Records a user-defined data point for analysis.

Arguments

name. The name of the data point (string). Do not begin a data-point name with any of these strings: HTTP, NON_HTTP, RETRY, mic_, stream_, mms_

value. The numeric value (number).

Return value (void)

undefined

Example

Back to top

Returns an array of the objects defined by the XPath in the argument.

Arguments

xpath. The xpath query (string).

Return value (void)

undefined

Example

Back to top

Starts a LoadRunner Professional transaction.

Arguments

name. (String) The name of the transaction to start.

Return value (void)

undefined

Example

Back to top

Ends a LoadRunner Professional transaction.

Arguments

name. The name of the transaction to end (string).

type. One of the following status values: “Pass”, “Fail”, “Auto”

Return value (void)

undefined

Example

Back to top

Indicates which Vuser is handling a specific script.

Arguments

text. Any text string (string).

Return value (void)

Undefined.

Example

Back to top

Enables you to change the log level during script replay. To restore initial log level setting, use TC.restoreLogLevel.

Arguments

level. Specify the log level:

• "Disabled". Disables the log level. It still captures a log including the error level.
• "Standard". Standard log captured.
• "Extended". Extended log file captured.

log_flags. (Object) If the log level is set to extended, you can specify which data is captured using Boolean(true/false) flags as properties of json_object.

Any flag which is omitted will be considered as “false”.

• log_http
• log_AUT
• log_parameters

Return value (void)

undefined

Example

• Disable the log level:

  TC.setLogLevel(“Set the log level to “Disabled”);

• Enable the standard log:

  TC.setLogLevel(“Standard”);

• Enable the extended log:

  TC.setLogLevel(“Extended”);

• Enable the extended log, and specify which logs to capture:

  TC.setLogLevel(“Extended”,{ log_http : true, log_AUT: true, log_parameters: true});

Back to top

Restore log level to the initial setting.

Arguments

None

Return value (void)

undefined

Example

Back to top

Enables you to set a proxy address manually in the script.

Arguments

option. Specify the type of proxy you want to use.

• "PROXY_NONE". No proxy
• "PROXY_SYSTEM". Use system proxy; settingsString will be ignored.
• "PROXY_MANUAL". Manually set proxy.
• "PROXY_PAC". Use a proxy auto-config (PAC) file.

settings. The details of the proxy setting (string).

Return value (void)

undefined

Example

• Use system proxy settings. The second argument is ignored, so it can be any string value, usually empty.

  Note: Because schema needs two arguments, the second one cannot be omitted.

  TC.setProxy("PROXY_SYSTEM", "");

• Manually set proxy and set separate proxy for different protocols (http & https)

  TC.setProxy("PROXY_MANUAL", '{"proxyShare":false,"proxyHttp":" proxy.xxx.com ","proxyHttpPort":8080,"proxySsl":" proxy.yyy.com ","proxySslPort":8080}');

• Manually set proxy and share the proxy settings for all protocols (http, https, …)

  Note: If you also specify an address for “proxySsl”, it will be ignored because “proxyShare” is set to true.

  TC.setProxy("PROXY_MANUAL", '{"proxyShare":true,"proxyHttp":"proxy.xxx.com","proxyHttpPort":8080}');

• Use manually set proxy which is already in memory (maybe set previously, maybe nothing is set).

  Note: If you are not sure which setting is in memory, it is recommended that you explicitly specify the proxy settings you want to use every time.

  TC.setProxy("PROXY_MANUAL ", "");

• Do not use any proxy.

  Note: The proxy address/port that are set in the options sections are not removed. The settings in memory can be activated in another call (refer to the next example).

  TC.setProxy("PROXY_NONE", "");

• Use PAC.

  TC.setProxy("PROXY_PAC",'{"proxyPAC":"http://autocache.xyzcorp.net/"}')

Back to top

Adding a filter to one of the denylist or allowlist lists of URLs. The URL of each HTTP request will be checked first against the denylist, and then the allowlist. HTTP requests that do not pass the check will be blocked.

Arguments

url. String or regular expression representing the URL (string).

isIncluded. True to add the URL to allowlist, or false to add the URL to denylist (boolean).

Return value (void)

undefined

Example

Set only the allowed domain on the allowlist. All other domains are blocked.

String example:

Regular expression example:

Back to top

Remove all filters from both the denylist and allowlist lists of URLs.

Arguments

None

Return value (void)

undefined

Example

Back to top

Adding an HTTP header to every consecutive HTTP requests following this function call.

Arguments

header. The name of the header to be added (string).

value. The value of the header to be added (string).

merge. "True" indicates to merge the value with an existing header by the same name; "false" indicates to overwrite it (boolean).

Note: Merge does not support modifying the following headers: "content-type", "content-disposition", "content-length", "user-agent", "referer", "host", "authorization", "proxy-authorization", "if-modified-since", "if-unmodified-since", "from", "location", "max-forwards"

Return value (void)

undefined

Example

Back to top

Removes all HTTP headers and stops adding HTTP headers to every consecutive HTTP request following this function call.

Arguments

None

Return value (void)

undefined

Example

Back to top

Removes an HTTP header added with Utils.addAutoHeader and stops adding this HTTP header to every consecutive HTTP request following this function call.

Arguments

header. The name of the header to be stopped from being added.

Return value (void)

undefined

Example

Back to top

Remove a filter that was added using Utils.addAutoFilter from the denylist or allowlist of URLs.

Arguments

filter. String representing the URL.

isInclude. True value indicates the allowlist, false otherwise.

Remarks

Use the exact same filter URL value that was added to the list.

Return value (void)

undefined

Example

Back to top

Removes all cookies currently stored by the Vuser.

Arguments

None

Return value (void)

undefined

Example

None

Back to top

Clears the cache of a single Vuser; the content of the whole cache simulator is unaffected.

Arguments

None

Return value (void)

undefined

Example

None

Back to top

Adds a new cell as the last field of a column to a value.

Equivalent method in LoadRunner Professional: lrvtc_send_message

Arguments

colName. The name of the column (string).

value. The value as a string (string).

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column specified in the argument does not exist, the column will be created and the cell content is set to the argument value.

Return value (number)

0 if completed successfully; on error returns undefined.

Example

Back to top

Sets the data in multiple columns.

Equivalent method in LoadRunner Professional: lrvtc_send_row1

Arguments

colNames. The column names delimited by a semi-colon (string).

values. The values as a string delimited by a semi-colon (string).

option. Define how the values are added (integer).

• 0. Add as same row in all columns based on the column with the highest row count. The created row will be n+1 for all columns.
• 1. Add as stack - last row in every column.
• 2. Add as unique stack - last row in every column only if the value is unique in the column.

vtsName. The alias of the VTS server (string, optional).

Remarks

If the columns specified in the argument do not exist, the columns will be created and the cell contents are set to the argument values.

Return value (number)

0 if completed successfully; on error returns undefined.

Example

Back to top

Sets the last field of a column to a value if the value does not exist in the column.

Equivalent method in LoadRunner Professional: lrvtc_send_if_unique

Arguments

colName. The name of the column (string).

value. The value (string).

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column specified in the argument does not exist, the column will be created and the cell content is set to the argument value.

Return value (boolean)

True if the value exists in the column, and false if the value does not.

Example

Back to top

Clears all data in a column.

Equivalent method in LoadRunner Professional: lrvtc_clear_column

Arguments

colName. The name of the column (string).

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column specified in the argument does not exist, the step will run without returning an error and no data in the VTS is changed.

Return value (number)

0 if completed successfully; on error returns undefined.

Example

Back to top

Clears the data in a field.

Equivalent method in LoadRunner Professional: lrvtc_clear_message

Arguments

colName. The name of the column (string).

rowIndex. The index number of the field (integer). 1 is the first field in the column.

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column or the row index specified in the argument does not exist, the step will run without returning an error and no data in the VTS will be changed.

Return value (number)

0 if completed successfully; on error returns undefined.

Example

Back to top

Clears the values from all fields in a row.

Equivalent method in LoadRunner Professional: lrvtc_clear_row

Arguments

rowIndex. The index number of the field (integer). 1 is the first field in the column.

VtsName. The alias of the VTS server (string, optional).

Remarks

If the row index specified in the argument does not exist, the step will run without returning an error and no data will be changed in the VTS.

Return value (number)

0 if completed successfully; on error returns undefined.

Example

Back to top

Returns the number of fields that contain data in a column.

Equivalent method in LoadRunner Professional: lrvtc_column_size

Arguments

colName. The name of the column (string).

vtsName. The alias of the VTS server (string, optional).

Return value (number)

Returns the number of fields in the column, or 0 if the column does not exist.

Example

Back to top

Creates a connection to the server (supports HTTP).

Equivalent method in LoadRunner Professional: lrvtc_connect

Arguments

serverName. Either the IP or server name (string).

port. The port number (integer).

vtsName. The alias of the VTS server (string, optional).

Return value (number)

0 if completed successfully; on error returns undefined.

Example

Back to top

Creates a connection to the server (supports HTTP, HTTPS version VTS server, basic authentication based on user name and password entered by the user, and NTLM authentication).

Equivalent method in LoadRunner Professional: lrvtc_connect_ex

Arguments

serverName. Either the IP or server domain name (string). The protocol can be omitted; the default protocol is “https://”.

port. The port number (integer). The available range is 1-65535.

userName. The user name for basic or NTLM authentication (string, optional).

password. The password for basic or NTLM authentication (string, optional).

domain. The domain name for NTLM authentication (string, optional).

vtsName. The name of the VTS connection (string, optional).

Return value (number)

0 if completed successfully; on error returns undefined.

Example

Back to top

Creates a column.

Equivalent method in LoadRunner Professional: lrvtc_create_column

Arguments

colName. The name of the column (string).

VtsName. The alias of the VTS server (string, optional).

Remarks

If a column of the same name already exists, the function does nothing.

Return value (number)

0 if completed successfully; on error returns undefined.

Example

Back to top

Disconnects from the server.

Equivalent method in LoadRunner Professional: lrvtc_disconnect

Arguments

vtsName. The alias of the VTS server (string, optional).

Return value (number)

0 if completed successfully; on error returns undefined.

Example

Back to top

Deletes the index on a column.

Equivalent method in LoadRunner Professional: lrvtc_drop_index

Arguments

colName. The column name (string).

vtsName. The alias of the VTS server (string, optional).

Return value (number)

0 if completed successfully; on error returns undefined.

Example

Back to top

Creates an index on a column.

Equivalent method in LoadRunner Professional: lrvct_ensure_index

Arguments

colName. The name of the column (string).

vtsName. The alias of the VTS server (string, optional).

Return value (number)

0 if completed successfully; on error returns undefined.

Example

Back to top

Returns the data in a field.

Equivalent method in LoadRunner Professional: lrvtc_query_column

Arguments

colName. The name of the column (string).

rowIndex. The index number of the field (integer). 1 is the first field in the column.

vtsName. The alias of the VTS server (string, optional).

Return value (string or undefined or null)

String if data exist in the column and row specified. Undefined if specified index does not exist. Null if specified column does not exist.

Example

Back to top

Returns the data in a row as a JavaScript object. The properties of the object will be set to the column names

Equivalent method in LoadRunner Professional: lrvtc_query_row

Arguments

rowIndex. The index number of the field (integer). 1 is the first field in the column.

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column specified in the argument does not exist, a null value will be returned for every column.

Return value (object)

Returns the field from the specified index in all columns. If the column does not have a value in the specified index, the value is an empty string. Example: {col1:”larry”,col2:””}

Example

Back to top

Increments a counter stored in a field.

Equivalent method in LoadRunner Professional: lrvtc_increment

Arguments

colName. The name of the column (string).

rowIndex. The index number of the field (integer). 1 is the first field in the column.

value. The value.

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column name specified in the argument does not exist, the column will be created and the cell referenced by the index will be set to the argument value.

If the index specified in the argument exceeds the column size, the cell is created by the specified index and the cell contents is set to the argument value.

If the column referenced by the index contains a string, the cell contents are replaced with the value argument.

Return value (number)

0 if completed successfully; on error returns undefined.

Example

Back to top

Pops the first field from a column.

Equivalent method in LoadRunner Professional: lrvtc_retrieve_message

Arguments

colName. The name of the column (string).

vtsName. The alias of the VTS server (string, optional).

Return value (string or null)

The value of the first index in the column row. Returns null if the column is empty or does not exist.

Example

Back to top

Pops the data in a row as a JavaScript object.

Arguments

vtsName. The alias of the VTS server (string, optional).

Return value (object)

Returns the first field from the columns. If the column is empty, the value is null. Example: {col1:”larry”,col2:null}

Example

Back to top

Pops the first fields from specified columns. Returned as a JavaScript object. The properties of the object will be set to the column names.

Equivalent method in LoadRunner Professional: lrvtc_retrieve_messages1

Arguments

colNames. The names of the columns (string).

vtsName. The alias of the VTS server (string, optional).

Return value (object)

Returns the first field from the specified columns. If the column is empty, the value is null. Example: {col1:”larry”,col2:null}

Example

Back to top

Retrieves the first field from the specified column and moves the values to the bottom.

Equivalent method in LoadRunner Professional: lrvtc_rotate_messages

Arguments

colName. The name of the column (string).

option. Define how the values are rotated (integer).

• 1. Add as stack - Retrieve data from column, and move it to the bottom to the last valid row of every column.

• 2. Add as unique stack - Retrieve data from column, and move it to the bottom to the last valid row if the data is unique.

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column name does not exist, null value will be retrieved.

Return value (object)

Returns the first field from the specified column. If the column is empty, the value is an empty string. Example: {col1:”larry”,col2:””}

Example

Back to top

Retrieves the first field from all columns and moves the values to the bottom.

Equivalent method in LoadRunner Professional: lrvtc_rotate_row

Arguments

option. Define how the values are rotated (integer).

• 0. Same row – Retrieve data from all columns and move it to the bottom for all columns, based on the column with the highest row count. The created row will be n+1 for all columns.
• 1. Add as stack - Retrieve data from all columns and move it to the bottom to the last valid row of every column.
• 2. Add as unique stack - Retrieve data from all columns and move it to the bottom to the last valid row of every column only if the data is unique.

vtsName. The alias of the VTS server (string, optional).

Remarks

If there is no data in a row, null value will be retrieved.

Return value (object)

Returns the first field from the columns. If column is empty, the value is an empty string. Example: {col1:”larry”,col2:””}

Example

Back to top

Retrieves the first field from the specified columns and moves the values to the bottom.

Equivalent method in LoadRunner Professional: lrvtc_rotate_messages1

Arguments

ColNames. The column names delimited by a semi-colon (string).

option. Define how the values are rotated (integer).

• 0. Same row – Retrieve data from all columns and move it to the bottom for all columns based on the column with the highest row count. The created row will be n+1 for all columns.

• 1. Add as stack - Retrieve data from all columns, and move it to the bottom to the last valid row of every column.

• 2. Add as unique stack - Retrieve data from all columns, and move it to the bottom to the last valid row of every column if the data is unique.

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column name does not exist, null value will be retrieved.

Return value (object)

Returns the first field from the specified columns. If the column is empty, the value will be an empty string. Example: {col1:”larry”,col2:””}

Example

Back to top

Searches for a row containing specific values in specific columns.

Equivalent method in LoadRunner Professional: lrvtc_search_row

Arguments

columns. The names of the columns to search. The column names are separated by the delimiter.

values. The values of the columns to search. The values are separated by the delimiter.

delimiter. The character that separates the column names and values in the lists. If a string, rather than a single character, is passed in delimiter, the string as a whole is the delimiter.

VtsName. The alias of the VTS server.

Remarks

If the column specified in the argument does not exist, the return value is 0. If more than one row meets the condition, the data from only one random row is returned.

Return value (number)

0: If API call was successful but no row is found.

1: If API call was successful and the row is found.

On call failure, it returns the error code.

Example

TC.vtcSearchRow("col1,col2", "a,b", ",", "test");

Back to top

Replaces a specific value inside a set of columns with a new value.

Equivalent method in LoadRunner Professional: lrvtc_update_all_message_ifequals

Arguments

ColNames. The column names delimited by a semi-colon (string).

Message. New value inside a set of columns (string).

Ifmessage. Original value inside a set of columns (string).

Delimiter. Delimiter to separate column names. By default, the separator value is a semi-colon (;).

Return value (number)

0 if completed successfully; on error returns undefined.

Example

Back to top

Replaces the data in a field.

Equivalent method in LoadRunner Professional: lrvtc_update_message

Arguments

colName. The name of the column (string).

rowIndex. The index number of the field (integer). 1 is the first field in the column.

value. The value (string).

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column name or index does not exist, the column and/or the cell referenced by the index will be created and the cell contents set to the argument value.

Return value (number)

0 if completed successfully; on error returns undefined.

Example

Back to top

Replaces the data in a field if the current data equals a given value.

Equivalent method in LoadRunner Professional: lrvtc_update_message_ifequals

Arguments

colName. The name of the column (string).

rowIndex. The index number of the field (integer). 1 is the first field in the column.

value. The replacement value (string).

comparedValue. If the current cell contents are the same as the comparedValue, the cell contents are replaced with value (string).

vtsName. The alias of the VTS server (string, optional).

Return value (boolean)

False if a field with the same value exists; true if there is no field with the same value in the column.

Example

Back to top

Replaces the data in multiple fields.

Equivalent method in LoadRunner Professional: lrvtc_update_row1

Arguments

ColNames. The column names delimited by a semi-colon (string).

rowIndex. The index number of the field (integer). 1 is the first field in the column.

values. The values as a string delimited by a semi-colon (string).

vtsName. The alias of the VTS server (string, optional).

Remarks

If the column name or index does not exist, the column and/or the cell referenced by the index will be created, and the cell contents set to the argument value.

Return value (number)

0 if completed successfully; on error returns undefined.

Example

Back to top

Returns the value of the command line parameter passed to the test or the default value set for it.

Arguments

name. The name of the command-line parameter (string).

The command-line parameter name is generally assigned by the user in the Additional Attributes tab in VuGen > Runtime Settings or in the Controller in the group command line argument.

When the test is run, the additional attribute or the group command line argument is passed to the test as a parameter in the command line. During test run, the value can be accessed with this function.

Return value (string)

Returns the value of the command line parameter passed to the test or the default value set for it.

Example

To get the Controller command line argument, -MyServerURL http://myserver.com, call:

TC.getAttr(“MyServerURL”);

Back to top

Creates the specified folder. If needed, creates all the folders necessary to complete the path.

Arguments

path. The absolute path of the folder (string).

Return value (void)

undefined

Example

Back to top

Deletes the specified folder or file. If a folder is specified, deletes all the files in the folder, including sub-directories.

Arguments

path. The absolute path of the folder or file (string).

Return value (void)

undefined

Example

Back to top

Returns all the data from the specified file. Converts the data from the specified charset to unicode.

Arguments

filename. The absolute path of the file (string).

charset. The charset of the file, if it is not UTF-8 (string).

Return value (string)

All the data from the specified file.

Example

Back to top

Writes the string to the specified file. If the file does not exist it is created.

Arguments

filename. The absolute path to the file (string).

input. The string to write to the file (string).

append. (boolean)

• true. Append the string to the end of the file (default).
• false. Overwrite the file with the string.

charset. The charset of the file, if it is not UTF-8 (string).

Return value (boolean)

Always returns true.

Example

The result content in the mylog.txt file:

Back to top

Returns the value of the specified environment variable. Returns an empty string if the specified variable does not exist.

Arguments

name. The name of the environment variable (string).

Return value (string)

Value of the specified environment variable. Returns an empty string if the specified variable does not exist.

Example

Back to top

Evaluates the specified JavaScript file in the arguments context.

Arguments

filename. The absolute path to the JavaScript file (string).

Return value (void)

undefined

Example

Back to top

Returns true if the specified environment variable exists and false if it does not exist.

Arguments

name. The name of the environment variable (string).

Return value (boolean)

True if the specified environment variable exists, and false if it does not exist.

Example

Back to top

Sets the named environment variable to the specified value. If the variable already has a value it is overwritten.

Arguments

name. The name of the environment variable (string).

value. The value to which to set the environment variable (string).

Return value (void)

undefined

Example

Back to top