Test Profiles


Test Profiles allow you to change the conditions that your site is tested under. In this guide we’ll demonstrate how to create and manage Test Profiles with the CLI and Node.js API.

Create a Test Profile

Required API Permission: Create Test Profiles
ParameterRequiredDescription
siteYesSite slug, found in Site settings.
nameYesA descriptive name given to the Test Profile.
deviceNoA Device tag sets the device emulation used for tests. Use the `calibre device-list` command for a list of options.
connectionNoA Connection tag sets the network throttling used for tests. Use the `calibre connection-list` command for a list of options.
cookiesNoOne or more cookies (array of hashes).
headersNoOne or many headers (array of hashes).
adblockerNoTurn on uBlock Adblock extension. Boolean. Default: false.
javascriptNoJavaScript Requests Allowed. Boolean. Default: true.

Update a Test Profile

Required API Permission: Update Test Profiles
ParameterRequiredDescription
uuidYesThe uuid of the Test Profile.
siteYesSite slug, found in Site settings.
nameNoA descriptive name given to the Test Profile.
deviceNoA Device tag sets the device emulation used for tests. Use the `calibre device-list` command for a list of options.
connectionNoA Connection tag sets the network throttling used for tests. Use the `calibre connection-list` command for a list of options.
cookiesNoOne or more cookies (array of hashes).
headersNoOne or many headers (array of hashes).
adblockerNoTurn on uBlock Adblock extension. Boolean. Default: false.
javascriptNoJavaScript Requests Allowed. Boolean. Default: true.

List Test Profiles

Required API Permission: Read Sites
ParameterRequiredDescription
siteYesSite slug, found in Site settings.

Delete a Test Profile

This is a dangerous and irreversible action. Deleting a Test Profile will also remove all corresponding test data.
Required API Permission: Delete Test Profiles
ParameterRequiredDescription
nameNoA descriptive name given to the Test Profile.
uuidYesThe uuid of the Test Profile.
siteYesSite slug, found in Site settings.

Related Articles