Using custom profiles

A profile defines what a desktop browser or mobile device looks like to a server. After you record a script, its profile is displayed in the Profile tab of the script settings window. You can also apply a custom profile to the script.

A custom profile can be used when recording or playing back a script. For example, you can customize a profile while recording to support features such as masquerading as a different browser than Firefox, or to set a cookie for a recording session.

You can save a custom profile to load it for other scripts. Saving a profile creates a file with a .gprof extension.

Create a profile

In the Recording tab of the Global Preferences screen, you can define default profiles to apply to new scripts.

Open the Customize Profile dialog box:

  • When recording a script: Click REC to display the recording settings, then click Customize.
    Customize button on the recording settings screen

  • When playing back a script: When you play back a script, either when you finish recording it or when you open a saved script, select the Profile tab and click Customize located next to Customize Profile.
    Customize button on the profile playback settings tab

Define the profile settings.
Customize profile

  • Device Name – This field is only available for Mobile Device profiles. By default, the device name is the name of the device selected through the Device Manager before recording the script. Enter a name to uniquely identify the custom profile.

  • User Agent – The default playback agent or the agent selected when you recorded the script is entered in this field.To select a different user agent, click Change To and select the agent from the list. If you are creating a profile for mobile device scripts, keep in mind that only the Chrome agent is supported for recording mobile scripts.

  • Headers – To add a header, click the add icon to the right of the Headers field, then enter a name and values in the fields. Repeat as necessary.

  • Screen width and Screen height (Mobile scripts only) – If you have already selected a device, the default dimensions are entered in these fields. To change the dimensions, enter the width and height in pixels.

  • Device Pixel Ratio (Mobile scripts only) – The device pixel ratio is the ratio between logical pixels and physical pixels. It determines how a device's screen resolution is interpreted by the CSS. The device pixel ratio makes it possible to render a web page at an appropriate size regardless of the device's actual screen size. For example, if the logical resolution is 360 x 640 but a device's actual screen resolution is 720 x 1280, the device pixel ratio must be set to 2 to scale the logical resolution to the physical resolution: (720/2) x (1280/2) = 360 x 640.
    The Device Pixel Ratio is specified automatically for most devices. If necessary, however, you can change the value in this field.

  • Concurrent connections per host (max) – Enter the maximum number of simultaneous HTTP connections allowed to connect to a single host. Default values are entered automatically for Mobile Device profiles.

  • Simultaneous HTTP requests (max) – Enter the maximum number of total requests allowed to execute at the same time.

Click Save to open the Save Profile dialog box. Enter a file name or accept the Device Name value as the default file name, then click Save.

Save the custom profile

You can export the profile settings to a file so you can import the profile into other scripts or use it for creating other custom profiles.

  1. In the Customize Profile screen, click Save to open the Save Profile dialog box.
  2. Navigate to the folder where you want to save the profile.
  3. In the File name field, type a unique and meaningful name for the profile.
  4. Click Save.
    The profile is saved as a .gprof file.

Modify a saved profile

You can load a previously saved profile into the Customize Profile dialog box to revise the profile or use it as the basis for another profile:

  1. In the Customize Profile screen, click Load to open the Load Profile dialog box.

  2. Navigate to and select the .gprof file, then click Open.
    The profile settings are displayed in the Customize Profile fields, overwriting any previous values.

  3. Modify the profile settings as described above.

  4. To update the original file or create a new file, click Save.