Package com.microsoft.playwright

Class Locator.ScreenshotOptions

  • Enclosing interface:
    Locator
    public static class Locator.ScreenshotOptions
extends Object

    • Field Detail

      • animations

        public ScreenshotAnimations animations
        When set to "disabled", stops CSS animations, CSS transitions and Web Animations. Animations get different treatment depending on their duration:
        • finite animations are fast-forwarded to completion, so they'll fire transitionend event.
        • infinite animations are canceled to initial state, and then played over after the screenshot.

        Defaults to "allow" that leaves animations untouched.

      • caret

        public ScreenshotCaret caret
        When set to "hide", screenshot will hide text caret. When set to "initial", text caret behavior will not be changed. Defaults to "hide".

      • mask

        public List<Locator> mask
        Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink box #FF00FF (customized by maskColor) that completely covers its bounding box.

      • maskColor

        public String maskColor
        Specify the color of the overlay box for masked elements, in CSS color format. Default color is pink #FF00FF.

      • omitBackground

        public Boolean omitBackground
        Hides default white background and allows capturing screenshots with transparency. Not applicable to jpeg images. Defaults to false.

      • path

        public Path path
        The file path to save the image to. The screenshot type will be inferred from file extension. If path is a relative path, then it is resolved relative to the current working directory. If no path is provided, the image won't be saved to the disk.

      • quality

        public Integer quality
        The quality of the image, between 0-100. Not applicable to png images.

      • scale

        public ScreenshotScale scale
        When set to "css", screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this will keep screenshots small. Using "device" option will produce a single pixel per each device pixel, so screenshots of high-dpi devices will be twice as large or even larger.

        Defaults to "device".

      • style

        public String style
        Text of the stylesheet to apply while making the screenshot. This is where you can hide dynamic elements, make elements invisible or change their properties to help you creating repeatable screenshots. This stylesheet pierces the Shadow DOM and applies to the inner frames.

      • type

        public ScreenshotType type
        Specify screenshot type, defaults to png.

    • Constructor Detail

      • ScreenshotOptions

        public ScreenshotOptions()

    • Method Detail

      • setAnimations

        public Locator.ScreenshotOptions setAnimations​(ScreenshotAnimations animations)
        When set to "disabled", stops CSS animations, CSS transitions and Web Animations. Animations get different treatment depending on their duration:
        • finite animations are fast-forwarded to completion, so they'll fire transitionend event.
        • infinite animations are canceled to initial state, and then played over after the screenshot.

        Defaults to "allow" that leaves animations untouched.

      • setCaret

        public Locator.ScreenshotOptions setCaret​(ScreenshotCaret caret)
        When set to "hide", screenshot will hide text caret. When set to "initial", text caret behavior will not be changed. Defaults to "hide".

      • setMask

        public Locator.ScreenshotOptions setMask​(List<Locator> mask)
        Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink box #FF00FF (customized by maskColor) that completely covers its bounding box.

      • setOmitBackground

        public Locator.ScreenshotOptions setOmitBackground​(boolean omitBackground)
        Hides default white background and allows capturing screenshots with transparency. Not applicable to jpeg images. Defaults to false.

      • setPath

        public Locator.ScreenshotOptions setPath​(Path path)
        The file path to save the image to. The screenshot type will be inferred from file extension. If path is a relative path, then it is resolved relative to the current working directory. If no path is provided, the image won't be saved to the disk.

      • setQuality

        public Locator.ScreenshotOptions setQuality​(int quality)
        The quality of the image, between 0-100. Not applicable to png images.

      • setScale

        public Locator.ScreenshotOptions setScale​(ScreenshotScale scale)
        When set to "css", screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this will keep screenshots small. Using "device" option will produce a single pixel per each device pixel, so screenshots of high-dpi devices will be twice as large or even larger.

        Defaults to "device".

      • setStyle

        public Locator.ScreenshotOptions setStyle​(String style)
        Text of the stylesheet to apply while making the screenshot. This is where you can hide dynamic elements, make elements invisible or change their properties to help you creating repeatable screenshots. This stylesheet pierces the Shadow DOM and applies to the inner frames.