WebLibrary
Ranorex Studio provides a wide range of web testing capabilities that require no coding skills. However, some functionality is impossible or a lot of work to implement without coding. The WebLibrary contains several useful methods that solve this issue.
To use them, simply ⇢ add the individual methods to the desired recording modules and configure them as described on this page.
On this page
DownloadFile
It may often be necessary to download a file during a web test. This is possible without any coding, but the DownloadFile method simplifies the process.
The available arguments for the method are:
String uri
- URI of the file to download.
- If the address is wrong or the file can’t be found, returns an error.
- In this case, the test module containing the method will fail and the report will log a failure.
String localPath
- The path to the folder where you want to save the file. Can be absolute or relative.
- If left empty, saves the file in the output folder of the test solution.
Boolean overwriteExisting
- true = if the file already exists in the target location, overwrites it.
- false = does not overwrite the file, but returns a warning and aborts the download.
The results are also logged to the report:
Report showing successful download of the file
Report showing aborted download, as the file already existed and overwriteExisting was set to false
Report showing a failed module because the file could not be downloaded
GetHttpStatusCode
Checks a website at the specified URL and returns its HTTP status code. The following arguments are available:
String returnValue
- The HTTP status code returned by the method.
- Can be passed on to a variable.
String url
- The URL of the website whose status you want to check.
The results are also logged to the report:
ReportFullPageScreenshot
Creates a full screenshot of a webpage, including elements that are currently not displayed on screen. The webpage must be saved as a repository item and passed to the method as an argument.
The screenshot is saved in the output folder and also logged to the report.
RepoItemInfo repoItemInfo
- The repository item that represents the webpage you want to screenshot.
- If it isn’t a webpage, an error will be logged to the report. The containing module will not fail, however.