WebLibrary | Ranorex Automation Helpers
Help CenterUser GuideRanorex Studio expert

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.