Changing Individual Page Resources

Document created by Chris Sommerstad Employee on Jul 21, 2017Last modified by Jijius Jabez on Aug 11, 2017
Version 2Show Document
  • View in full screen mode

Page resources within a test can be controlled at the page level, clip wide, or at the track or composition levels. For an individual page, double-click to open its properties in the lower panel. For clip-wide changes to all pages, click the Properties tab and then the Page Resource Settings node in the properties list.


Changing Individual Page Resource Settings

Page resource settings start at the page level.

To view properties for any page, select and double-click it to open a Selected: <Page Name> tab in the lower panel. This tab has three sub-tabs: General and Resource Settings.

The General tab contains the editable Page Name, optional Description, and page-wide “Errors should” setting whose possible values are “fail the page” or “be recorded only”.

Click the Resource Settings tab to edit the item’s properties.

In the left section, Load Page Resources settings are presented. Load Page Resources is checked by default. Un-checking this box makes all subordinate options inactive and page resources are not loaded as part of the test at runtime.

When Load Page Resources is checked, the Static and Dynamic boxes are checked or unchecked for the selected page based on its current settings (either those used in the Create a Clip from Recording Wizard or those that were applied manually at a later time).

  • Click Use HTML Document Settings to keep or adopt settings from the given HTML document. If Dynamic is checked, and UseHTML Document Settings is clicked, then the additional custom settings below are active.

Note: For converted clips, HTML Document settings were created when Mark the first page to dynamically retrieve its resources was checked in the Create Pages step of the wizard.

  • If Dynamic is checked, the Dynamic settings below are active. To create custom settings for Dynamic resources, click Use These Settings. When you do so, the custom settings on the right become active.

Set all of the following:

      • Errors should: either fail the clip or be recorded only depending on the stringency of testing desired.
      • Socket read timeout: Enter a value in milliseconds (ms) to set a timeout for each resource within the test set. The default is 120,000 ms (or 2 minutes).
      • Max Receive Content Length (bytes): Specify a maximum number (in bytes) for the response content. For example, for cases such as those involving large media files.

The Max Receive Content Length can also be set in the Target’s General, Content Options section, per server via the Servers > Maestro service settings (for Cloud users), and also at the individual message level in the Clip Editor.

    • Validation: Is either controlled by the target, enabled for this message, or disabled for this message.
      • If enabled for this message was selected, set Failures from among:
        • Fail the clip
        • Are recorded only
        • Honor the message setting

Check the “Retrieve nested CSS resources” checkbox to get CSS resources that are nested within first-level CSS resources. CSS retrieval beyond the first level can be turned on at the page, click, track, and composition levels by checking this box. This feature permits the user to filter all of the assets retrieved from a CSS that was dynamically retrieved, but not to filter the CSS itself. In such cases, the CSS file and its contents are retrieved without further recursion of its named assets.

Include/Exclude Resources by Expression

Use the Resources to Include or Exclude checkbox on the right of the tab to define resource includes and excludes via regular expression or glob. Both Regex and Glob can be set to include or exclude by the criteria defined. These excludes and includes will apply to both statically retrieved and dynamically retrieved resources, so they can be used as a quick filtering mechanism.

  1. Check the Resources to Include or Exclude box on the right of the Resource Settings tab to define includes and excludes via regular expression or glob.

    1. Click Apply list to: and select from among Dynamic Resources Only, Static Resources Only, or All Resources.
    2. In the text entry field at the bottom enter the expression to use.
    3. Choose Regex or Glob.

Define an expression to include or exclude a given resource.

For example:

      • The Regex expression to match any string containing “widget.js” would be:


      • The Glob expression to do the same thing would be:


Note: In CloudTest, when you are entering a Regular Expression for a Session Template, to include/exclude resources in a page, or for a PropSet in the Message Editor portion of the Clip Editor, you are entering a Java regular expression. Whereas, when you use regular expressions within a script (via the RegExp object or the /pattern/ notation), you are using a JavaScript regular expression. The two are not interchangeable, so you can’t copy expressions from one to the other. See Regular Expression Support in CloudTest for more information.

  1. Select to Include or Exclude matching resources.
  2. Click Add once an expression has been entered. Define additional expressions if desired.

The list can be ordered using the up or down arrows on the top right.

The Page Resource Settings node in the Clip Editor contains three main override setting types, each of which delivers comprehensive override control of the pages in a given test clip. The Page Resource Settings tab appears in the Composition Editor

  • Page Resource Loading (formerly Page Resources) settings at the clip level to honor, enable, or disable pages in a test clip.
  • Cache Dynamic Resource settings at the clip level to enable or disable caching. Caching starts at the clip level, so there are no page cache settings to override.
  • Page Resource Filtering (Include/Exclude Expressions) at the clip level to add to or replace include/exclude filtering performed in pages (e.g. for all page(s) in the clip).