Package org.openqa.selenium.devtools.page

Class Page

  • public class Page
extends java.lang.Object
    Actions and events related to the inspected page belong to the page domain.

    • Constructor Detail

      • Page

        public Page()

    • Method Detail

      • addScriptToEvaluateOnLoad

        @Beta
@Deprecated
public static Command<ScriptIdentifier> addScriptToEvaluateOnLoad​(java.lang.String scriptSource)
        Deprecated.
        Deprecated, please use addScriptToEvaluateOnNewDocument instead.

      • addScriptToEvaluateOnNewDocument

        public static Command<ScriptIdentifier> addScriptToEvaluateOnNewDocument​(java.lang.String source,
                                                                         java.util.Optional<java.lang.String> worldName)
        Evaluates given script in every frame upon creation (before loading frame's scripts).

      • bringToFront

        public static Command<java.lang.Void> bringToFront()
        Brings page to front (activates tab).

      • captureScreenshot

        public static Command<java.lang.String> captureScreenshot​(java.util.Optional<Page.CaptureScreenshotFormat> format,
                                                          java.util.Optional<java.lang.Integer> quality,
                                                          java.util.Optional<Viewport> clip,
                                                          java.util.Optional<java.lang.Boolean> fromSurface)
        Capture page screenshot.

      • captureSnapshot

        @Beta
public static Command<java.lang.String> captureSnapshot​(java.util.Optional<Page.CaptureSnapshotFormat> format)
        Returns a snapshot of the page as a string. For MHTML format, the serialization includes iframes, shadow DOM, external resources, and element-inline styles.

      • clearDeviceMetricsOverride

        @Beta
@Deprecated
public static Command<java.lang.Void> clearDeviceMetricsOverride()
        Deprecated.
        Clears the overriden device metrics.

      • clearDeviceOrientationOverride

        @Beta
@Deprecated
public static Command<java.lang.Void> clearDeviceOrientationOverride()
        Deprecated.
        Clears the overridden Device Orientation.

      • clearGeolocationOverride

        @Deprecated
public static Command<java.lang.Void> clearGeolocationOverride()
        Deprecated.
        Clears the overriden Geolocation Position and Error.

      • createIsolatedWorld

        public static Command<ExecutionContextId> createIsolatedWorld​(FrameId frameId,
                                                              java.util.Optional<java.lang.String> worldName,
                                                              java.util.Optional<java.lang.Boolean> grantUniveralAccess)
        Creates an isolated world for the given frame.

      • deleteCookie

        @Beta
@Deprecated
public static Command<java.lang.Void> deleteCookie​(java.lang.String cookieName,
                                                   java.lang.String url)
        Deprecated.
        Deletes browser cookie with given name, domain and path.

      • disable

        public static Command<java.lang.Void> disable()
        Disables page domain notifications.

      • enable

        public static Command<java.lang.Void> enable()
        Enables page domain notifications.

      • getManifestIcons

        @Beta
public static Command<java.lang.String> getManifestIcons()

      • getCookies

        @Beta
@Deprecated
public static Command<java.util.List<Cookie>> getCookies()
        Deprecated.
        Returns all browser cookies. Depending on the backend support, will return detailed cookie information in the `cookies` field.

      • getFrameTree

        public static Command<FrameTree> getFrameTree()
        Returns present frame tree structure.

      • resetNavigationHistory

        public static Command<java.lang.Void> resetNavigationHistory()
        Resets navigation history for the current page.

      • getResourceTree

        @Beta
public static Command<FrameResourceTree> getResourceTree()
        Returns present frame / resource tree structure.

      • handleJavaScriptDialog

        public static Command<java.lang.Void> handleJavaScriptDialog​(java.lang.Boolean accept,
                                                             java.util.Optional<java.lang.String> promptText)
        Accepts or dismisses a JavaScript initiated dialog (alert, confirm, prompt, or onbeforeunload).

      • navigate

        public static Command<Page.NavigateResponse> navigate​(java.lang.String url,
                                                      java.util.Optional<java.lang.String> referrer,
                                                      java.util.Optional<TransitionType> transitionType,
                                                      java.util.Optional<FrameId> frameId,
                                                      java.util.Optional<ReferrerPolicy> referrerPolicy)
        Navigates current page to the given URL.

      • navigateToHistoryEntry

        public static Command<java.lang.Void> navigateToHistoryEntry​(java.lang.Integer entryId)
        Navigates current page to the given history entry.

      • printToPDF

        public static Command<Page.PrintToPDFResponse> printToPDF​(java.util.Optional<java.lang.Boolean> landscape,
                                                          java.util.Optional<java.lang.Boolean> displayHeaderFooter,
                                                          java.util.Optional<java.lang.Boolean> printBackground,
                                                          java.util.Optional<java.lang.Number> scale,
                                                          java.util.Optional<java.lang.Number> paperWidth,
                                                          java.util.Optional<java.lang.Number> paperHeight,
                                                          java.util.Optional<java.lang.Number> marginTop,
                                                          java.util.Optional<java.lang.Number> marginBottom,
                                                          java.util.Optional<java.lang.Number> marginLeft,
                                                          java.util.Optional<java.lang.Number> marginRight,
                                                          java.util.Optional<java.lang.String> pageRanges,
                                                          java.util.Optional<java.lang.Boolean> ignoreInvalidPageRanges,
                                                          java.util.Optional<java.lang.String> headerTemplate,
                                                          java.util.Optional<java.lang.String> footerTemplate,
                                                          java.util.Optional<java.lang.Boolean> preferCSSPageSize,
                                                          java.util.Optional<Page.PrintToPDFTransferMode> transferMode)
        Print page as PDF.

      • reload

        public static Command<java.lang.Void> reload​(java.util.Optional<java.lang.Boolean> ignoreCache,
                                             java.util.Optional<java.lang.String> scriptToEvaluateOnLoad)
        Reloads given page optionally ignoring the cache.

      • removeScriptToEvaluateOnLoad

        @Beta
@Deprecated
public static Command<java.lang.Void> removeScriptToEvaluateOnLoad​(ScriptIdentifier identifier)
        Deprecated.
        Deprecated, please use removeScriptToEvaluateOnNewDocument instead.

      • removeScriptToEvaluateOnNewDocument

        public static Command<java.lang.Void> removeScriptToEvaluateOnNewDocument​(ScriptIdentifier identifier)
        Removes given script from the list.

      • screencastFrameAck

        @Beta
public static Command<java.lang.Void> screencastFrameAck​(java.lang.Integer sessionId)
        Acknowledges that a screencast frame has been received by the frontend.

      • searchInResource

        @Beta
public static Command<java.util.List<SearchMatch>> searchInResource​(FrameId frameId,
                                                                    java.lang.String url,
                                                                    java.lang.String query,
                                                                    java.util.Optional<java.lang.Boolean> caseSensitive,
                                                                    java.util.Optional<java.lang.Boolean> isRegex)
        Searches for given string in resource content.

      • setAdBlockingEnabled

        @Beta
public static Command<java.lang.Void> setAdBlockingEnabled​(java.lang.Boolean enabled)
        Enable Chrome's experimental ad filter on all sites.

      • setBypassCSP

        @Beta
public static Command<java.lang.Void> setBypassCSP​(java.lang.Boolean enabled)
        Enable page Content Security Policy by-passing.

      • setDeviceMetricsOverride

        @Beta
@Deprecated
public static Command<java.lang.Void> setDeviceMetricsOverride​(java.lang.Integer width,
                                                               java.lang.Integer height,
                                                               java.lang.Number deviceScaleFactor,
                                                               java.lang.Boolean mobile,
                                                               java.util.Optional<java.lang.Number> scale,
                                                               java.util.Optional<java.lang.Integer> screenWidth,
                                                               java.util.Optional<java.lang.Integer> screenHeight,
                                                               java.util.Optional<java.lang.Integer> positionX,
                                                               java.util.Optional<java.lang.Integer> positionY,
                                                               java.util.Optional<java.lang.Boolean> dontSetVisibleSize,
                                                               java.util.Optional<ScreenOrientation> screenOrientation,
                                                               java.util.Optional<Viewport> viewport)
        Deprecated.
        Overrides the values of device screen dimensions (window.screen.width, window.screen.height, window.innerWidth, window.innerHeight, and "device-width"/"device-height"-related CSS media query results).

      • setDeviceOrientationOverride

        @Beta
@Deprecated
public static Command<java.lang.Void> setDeviceOrientationOverride​(java.lang.Number alpha,
                                                                   java.lang.Number beta,
                                                                   java.lang.Number gamma)
        Deprecated.
        Overrides the Device Orientation.

      • setFontFamilies

        @Beta
public static Command<java.lang.Void> setFontFamilies​(FontFamilies fontFamilies)
        Set generic font families.

      • setFontSizes

        @Beta
public static Command<java.lang.Void> setFontSizes​(FontSizes fontSizes)
        Set default font sizes.

      • setDocumentContent

        public static Command<java.lang.Void> setDocumentContent​(FrameId frameId,
                                                         java.lang.String html)
        Sets given markup as the document's HTML.

      • setDownloadBehavior

        @Beta
@Deprecated
public static Command<java.lang.Void> setDownloadBehavior​(Page.SetDownloadBehaviorBehavior behavior,
                                                          java.util.Optional<java.lang.String> downloadPath)
        Deprecated.
        Set the behavior when downloading a file.

      • setGeolocationOverride

        @Deprecated
public static Command<java.lang.Void> setGeolocationOverride​(java.util.Optional<java.lang.Number> latitude,
                                                             java.util.Optional<java.lang.Number> longitude,
                                                             java.util.Optional<java.lang.Number> accuracy)
        Deprecated.
        Overrides the Geolocation Position or Error. Omitting any of the parameters emulates position unavailable.

      • setLifecycleEventsEnabled

        @Beta
public static Command<java.lang.Void> setLifecycleEventsEnabled​(java.lang.Boolean enabled)
        Controls whether page will emit lifecycle events.

      • setTouchEmulationEnabled

        @Beta
@Deprecated
public static Command<java.lang.Void> setTouchEmulationEnabled​(java.lang.Boolean enabled,
                                                               java.util.Optional<Page.SetTouchEmulationEnabledConfiguration> configuration)
        Deprecated.
        Toggles mouse event-based touch event emulation.

      • startScreencast

        @Beta
public static Command<java.lang.Void> startScreencast​(java.util.Optional<Page.StartScreencastFormat> format,
                                                      java.util.Optional<java.lang.Integer> quality,
                                                      java.util.Optional<java.lang.Integer> maxWidth,
                                                      java.util.Optional<java.lang.Integer> maxHeight,
                                                      java.util.Optional<java.lang.Integer> everyNthFrame)
        Starts sending each frame using the `screencastFrame` event.

      • stopLoading

        public static Command<java.lang.Void> stopLoading()
        Force the page stop all navigations and pending resource fetches.

      • crash

        @Beta
public static Command<java.lang.Void> crash()
        Crashes renderer on the IO thread, generates minidumps.

      • close

        @Beta
public static Command<java.lang.Void> close()
        Tries to close page, running its beforeunload hooks, if any.

      • setWebLifecycleState

        @Beta
public static Command<java.lang.Void> setWebLifecycleState​(Page.SetWebLifecycleStateState state)
        Tries to update the web lifecycle state of the page. It will transition the page to the given state according to: https://github.com/WICG/web-lifecycle/

      • stopScreencast

        @Beta
public static Command<java.lang.Void> stopScreencast()
        Stops sending each frame in the `screencastFrame`.

      • setProduceCompilationCache

        @Beta
public static Command<java.lang.Void> setProduceCompilationCache​(java.lang.Boolean enabled)
        Forces compilation cache to be generated for every subresource script.

      • addCompilationCache

        @Beta
public static Command<java.lang.Void> addCompilationCache​(java.lang.String url,
                                                          java.lang.String data)
        Seeds compilation cache for given url. Compilation cache does not survive cross-process navigation.

      • clearCompilationCache

        @Beta
public static Command<java.lang.Void> clearCompilationCache()
        Clears seeded compilation cache.

      • generateTestReport

        @Beta
public static Command<java.lang.Void> generateTestReport​(java.lang.String message,
                                                         java.util.Optional<java.lang.String> group)
        Generates a report for testing.

      • waitForDebugger

        @Beta
public static Command<java.lang.Void> waitForDebugger()
        Pauses page execution. Can be resumed using generic Runtime.runIfWaitingForDebugger.

      • setInterceptFileChooserDialog

        @Beta
public static Command<java.lang.Void> setInterceptFileChooserDialog​(java.lang.Boolean enabled)
        Intercept file chooser requests and transfer control to protocol clients. When file chooser interception is enabled, native file chooser dialog is not shown. Instead, a protocol event `Page.fileChooserOpened` is emitted.

      • frameClearedScheduledNavigation

        public static Event<FrameId> frameClearedScheduledNavigation()

      • frameDetached

        public static Event<FrameId> frameDetached()

      • frameNavigated

        public static Event<Frame> frameNavigated()

      • frameResized

        public static Event<java.lang.Void> frameResized()

      • frameStartedLoading

        public static Event<FrameId> frameStartedLoading()

      • frameStoppedLoading

        public static Event<FrameId> frameStoppedLoading()

      • interstitialHidden

        public static Event<java.lang.Void> interstitialHidden()

      • interstitialShown

        public static Event<java.lang.Void> interstitialShown()

      • screencastVisibilityChanged

        public static Event<java.lang.Boolean> screencastVisibilityChanged()