File Wait Test Step
About File Wait test step
Use the File Wait test step to check whether a file exists on your hard drive. The test step pauses the test run until the specified file is found or until the specified time period is over.
Requirements
To use this test step, you need ReadyAPI Test Licenses. If you do not have it, you can request it on our website or start a trial.
Editing File Wait test step
You can modify settings of a test step in its editor:
![]() |
Important
You can use Property Expansions in the editor.
Property list
Besides the test step editor, you can adjust the test step’s behavior by using its properties in the FileWaitRequestTestStep Properties and Custom File Wait Test Step Properties panels in the Navigator.
FileWaitRequestTestStep Properties
Name | Description |
---|---|
Name | The test step’s name. |
Description | Text describing the test step. |
File name | The fully qualified name of the needed file. This property is read-only. You can specify the file name in the test step editor, or in the fileName property on the Custom File Wait Test Step Properties tab. |
Custom File Wait Test Step Properties
Values on the Custom File Wait Test Step Properties tab are available to other test steps in your project. For instance, you can verify these property values with the Assertion test step, or check them and change the execution flow with the Conditional GoTo test step.
You can modify custom properties, load their values from a file, or save them to a file. To learn more, see About Properties.
This tab contains the following properties that provide access to the request and response data:
Name | Description |
---|---|
deleteFile |
|
fileName | The fully qualified name of the desired file. |
fileContent | The contents of the desired file. ReadyAPI populates this property only if the test step is passed. |
timeout | The wait time in milliseconds. |
Verifying test step
If the file was found during the specified period, the test step passes. Otherwise, it fails.
In the log, you can see whether the test step failed or passed.
If the test step passes, the fileContent property contains data from the specified file. You can use the Contains or Equals assertions to verify the file contents.