Exists Property

Applies to TestComplete 15.0, last modified on November 17, 2021

Description

The Exists property returns True if the file to which the given aqFileInfoObj object corresponds is found. Otherwise, the property returns False.

Declaration

aqFileInfoObj.Exists

Read-Only Property Boolean
aqFileInfoObj An expression, variable or parameter that specifies a reference to an aqFileInfo object

Applies To

The property is applied to the following object:

Property Value

True if the file exists, and False otherwise.

Remarks

If you try to obtain the aqFileInfo object for a file that does not exist, an error will occur.

Example

The code below checks file availability. If the file exists, the Hello, World! text line will be added to its contents. Otherwise, the script will throw an exception.

JavaScript

function aqFileInfoExample()
{
 let sPath = "C:\\FileName.txt";
 try 
 {
    //Checks whether the desired file exists
  if (aqFileSystem.GetFileInfo(sPath).Exists)
  {
    aqFileSystem.GetFileInfo(sPath).WriteToTextFile("Hello, World!!", aqFile.ctANSI);
  }
 }
 catch(e)
 {
    // Posts an error message to the test log
   Log.Error(e.message);
 }
}

JScript

function aqFileInfoExample()
{
 var sPath = "C:\\FileName.txt";
 try 
 {
    //Checks whether the desired file exists
  if (aqFileSystem.GetFileInfo(sPath).Exists)
  {
    aqFileSystem.GetFileInfo(sPath).WriteToTextFile("Hello, World!!", aqFile.ctANSI);
  }
 }
 catch(e)
 {
    // Posts an error message to the test log
   Log.Error(e.description);
 }
}

Python

def aqFileInfoExistsExample():
  sPath = "C:\\MyFile.txt"
  try: 
    FileInf = aqFileSystem.GetFileInfo(sPath)
    # Performs actions over the file
    # ...
    # Checks whether the specified file has not been deleted or moved 
    if FileInf.Exists:
      # Writes text to the file 
      FileInf.WriteToTextFile("Hello, world!", aqFile.ctANSI)
  except Exception as e:
    Log.Error("The file has been deleted or removed.")

VBScript

Sub aqFileInfoExample
  Dim sPath, File
  sPath = "C:\asdf\vvasdasd.txt"
  Err.Clear
  On Error Resume Next
    ' Checks whether the desired file exists
    Set File = aqFileSystem.GetFileInfo(sPath)
    If aqFileSystem.GetFileInfo(sPath).Exists Then
    ' Writes text to the file
     Call aqFileSystem.GetFileInfo(sPath).WriteToTextFile("Hello, World!", aqFile.ctANSI)
    End If 
  If Err.Number <> 0 Then
    ' Posts an error message to the test log
    Log.Error Err.Description
  End If
End Sub

DelphiScript

function aqFileInfoExample;
var sPath;

begin

 sPath := 'C:\FileName.txt';
 
 try
 // Checks whether the desired file exists
 if aqFileSystem.GetFileInfo(sPath).Exists then
    // Writes text to the file
    aqFileSystem.GetFileInfo(sPath).WriteToTextFile('Hello, World!', aqFile.ctANSI);
 
 except
    // Posts an error message to the test log
    Log.Error(ExceptionMessage);
 end;
end;

C++Script, C#Script

function aqFileInfoExample()
{
 var sPath = "C:\\FileName.txt";
 try
 {
    // Checks whether the desired file exists
    if (aqFileSystem["GetFileInfo"](sPath)["Exists"])
    {
      // Writes text to the file
      aqFileSystem["GetFileInfo"](sPath)["WriteToTextFile"]( "Hello, World!!", aqFile["ctANSI"] );
    }
 }
 
 catch(e)
 {
    // Posts an error message to the test log
    Log["Error"](e["description"]);
 }
}

See Also

Working With Files From Scripts
GetFileInfo Method
Name Property
Path Property

Highlight search results