Adding download assertions
Adding download steps in your mabl trainer
Mabl detects and adds download steps automatically whenever a download completes during a training session.
- Start a new test or edit/retrain an existing test.
- Trigger the download of interest. (In other words, click on the download link or button).
Upon download completion, mabl will show a new assertion step for your download.
Custom find clicks
A click step that uses custom find will not trigger a download assertion.
Configuring download assertion steps
By default, downloads will assert against the name of the downloaded file. You may add/edit additional assertions by hovering over the download assertion step and clicking the pencil icon that appears.
Additional attributes for a download assertion include the following:
| Attribute | Details |
|---|---|
| Filename | Assert downloaded file has the give file name (case sensitive), except for auto-numbering |
| MIME type | Assert downloaded file was sent with the expected headers (case insensitive) |
| Exact file size | Assert downloaded file is an exact size in bytes |
| Minimum file size | Assert downloaded file is at least a given number of bytes |
| Maximum file size | Assert downloaded file is at most at given number of bytes |
Download assertion limitations
Mabl does not currently support download assertions for the following:
- Dynamic file names
- Partial strings in file names
If either of these assertion types would be helpful for you, consider submitting a feature request in the mabl Product Portal.
Auto-numbering removal
Browsers add numbers to repeatedly downloaded files. For example, foo.zip will be foo (1).zip when downloaded twice in Google Chrome. The download filename assertion will automatically elide these numbers during assertions so that foo (1).zip becomes foo.zip for the assertion comparison. This feature enables replay testing without need of manual file cleanup.
Manual download limit
When training in Chrome, you may only automatically download the file 100 times due to Chrome limits. After downloading the same file 100 times, Chrome will open a save file modal for every additional download, preventing automatic replay of the download step. Remove the downloaded files to restore replay functionality.
Running download assertions
Mabl will detect the moment a download completes and assert against it then. There is no need to add explicit waits to work with downloads, unless the download takes longer than the default 30 second download timeout. This timeout is not presently configurable.
Browser support
Assertions on PDF downloads are only supported in the following browsers:
- Chrome
- Firefox
- Edge
Concurrent download support
Mabl presently supports only sequential downloads. If you have a use case requiring multiple parallel downloads, please let us know in the mabl Product Portal.
Updated about 1 month ago