Package com.microsoft.playwright

Class ElementHandle.ScreenshotOptions

  • Enclosing interface:
    ElementHandle
    public static class ElementHandle.ScreenshotOptions
extends java.lang.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 java.util.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 java.lang.String maskColor
        Specify the color of the overlay box for masked elements, in CSS color format. Default color is pink #FF00FF.

      • omitBackground

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

      • path

        public java.nio.file.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 java.lang.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".

      • type

        public ScreenshotType type
        Specify screenshot type, defaults to png.

    • Constructor Detail

      • ScreenshotOptions

        public ScreenshotOptions()

    • Method Detail

      • setAnimations

        public ElementHandle.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.

      • setMask

        public ElementHandle.ScreenshotOptions setMask​(java.util.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 ElementHandle.ScreenshotOptions setOmitBackground​(boolean omitBackground)
        Hides default white background and allows capturing screenshots with transparency. Not applicable to jpeg images. Defaults to false.

      • setPath

        public ElementHandle.ScreenshotOptions setPath​(java.nio.file.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.

      • setScale

        public ElementHandle.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".