VisualGridOption method

Class: VisualGridOptionPlatform: Selenium 3Language: C# SDK:

Create an option key/value pair to pass to the Visual Grid.

Syntax


VisualGridOption obj = new VisualGridOption(key, value);

Parameters

key
Type:string
The option key.
value
Type:object
The option key.

Return value

Type: VisualGridOption

Remarks

The following configuration values are currently supported:

"polyfillAdoptedStyleSheets"

Adopted Stylesheets are a way to create and distribute reusable styles when using a Shadow DOM. Adopted Stylesheets are not supported by all browsers, so their use may cause mismatches when doing cross-browser validation. By default, when the Ultrafast Grid detects that a page being checked uses Adopted Stylesheets, it will not render that checkpoint, the check will fail, and the test will be aborted. In the Test Manager, the test results for that run will have an Aborted status, and the step that failed will have a Missing status.

To enable rendering of checkpoints that include Adopted Stylesheets, and to ensure that the test can complete successfully, you need to explicitly set the Ultrafast Grid option "polyfillAdoptedStyleSheets" to a value of true or false:

  • Setting a value of true instructs the Ultrafast Grid to polyfill Adopted Stylesheets.
  • Setting a value of false instructs the Ultrafast Grid to render the page without polyfilling Adopted Stylesheets.

You can set this option globally using the method Configuration.SetVisualGridOptions

You can override the global value for a given checkpoint using the method SeleniumCheckSettings.VisualGridOptions.

Example

Pass an object of the type VisualGridOption to the Configuration.SetVisualGridOptions method or Configuration.VisualGridOptions property to set the default value of an option for an entire test suite or test.

/* test suite setup */  
suiteConfig = new Configuration(); 
suiteConfig 
        .SetVisualGridOptions(new VisualGridOption("polyfillAdoptedStyleSheets", true))   
    /* other configurations */;  

/* 
    start the test and apply the suite configuration 
*/
eyes = new Eyes(runner); 
eyes.SetConfiguration(suiteConfig); 

The option value can be overridden for a given checkpoint using the method SeleniumCheckSettings.VisualGridOptions.

eyes.Check(
   Target.Window()
   .VisualGridOptions(new VisualGridOption("polyfillAdoptedStyleSheets", true)));
.