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.

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, save 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:

1. Report showing successful download of the file

2. Report showing aborted download, as the file already existed and overwriteExisting was set to false

3. Report showing a failed module because the file could not be downloaded

Checks a website at the specified URL and returns its HTTP status code. The following arguments are available:

String returnValue

• The HTTP status code is 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:

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 into 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.