Description

The aqEnvironment.IsScriptExtensionInstalled method checks whether a certain script extension is installed and enabled in TestComplete. The extension can be specified by its name and, optionally, vendor and version (you can learn all of this information from the Script Extensions dialog). The method returns a boolean value that indicates the check result - True if the specified extension is available in TestComplete and False otherwise.

Declaration

aqEnvironment.IsScriptExtensionInstalled(PluginName, PluginAuthor, PluginVersion)

PluginName	[in]	Required	String
PluginAuthor	[in]	Optional	String	Default value: Empty string
PluginVersion	[in]	Optional	String	Default value: Empty string
Result	Boolean

Applies To

The method is applied to the following object:

aqEnvironment

Parameters

The method has the following parameters:

PluginName

The name of the script extension. This value is displayed in the Name column of the Script Extensions dialog. This parameter is case-insensitive.

PluginAuthor

The name of the script extension’s vendor. This value is displayed in parentheses after the extension’s version in the Name column of the Script Extensions dialog.

The vendor name is case-insensitive. If it is omitted or equal to an empty string, TestComplete will perform a vendor-independent check.

PluginVersion

The version of the script extension. This value is displayed in parentheses after the extension’s name in the Name column of the Script Extensions dialog.

The version string is case-insensitive. If it is omitted or equal to an empty string, TestComplete will perform a version-independent check.

Result Value

True, if the specified script extension is installed and enabled in TestComplete. False, if the extension is not installed or disabled in the Script Extensions dialog.

Remarks

To check whether a certain plugin is installed in TestComplete, use the aqEnvironment.IsPluginInstalled method.

Example

The following code snippet checks if the WMI Object extension is available:

JavaScript, JScript

function Test()
{
  if (aqEnvironment.IsScriptExtensionInstalled("WMI Object"))
    WMI.PostDrivesInfo();
  else
    Log.Error("The \"WMI Object\" script extension is not available.");
}

Python

def Test():
  if aqEnvironment.IsScriptExtensionInstalled("WMI Object"):
    WMI.PostDrivesInfo()
  else:
    Log.Error("The \"WMI Object\" script extension is not available.")

VBScript

Sub Test
  If aqEnvironment.IsScriptExtensionInstalled("WMI Object") Then
    WMI.PostDrivesInfo
  Else
    Log.Error "The ""WMI Object"" script extension is not available."
  End If
End Sub

DelphiScript

procedure Test;
begin
  if aqEnvironment.IsScriptExtensionInstalled('WMI Object') then
    WMI.PostDrivesInfo
  else
    Log.Error('The "WMI Object" script extension is not available.');
end;