Class PageObject

    • Field Detail

      • jsonParser

        protected com.fasterxml.jackson.databind.ObjectMapper jsonParser
    • Constructor Detail

      • PageObject

        public PageObject​( injector,
                          URL url)
      • PageObject

        protected PageObject​(PageObject context,
                             URL url)
    • Method Detail

      • createRandomName

        public static String createRandomName()
      • getJenkins

        public Jenkins getJenkins()
      • open

        public org.openqa.selenium.WebDriver open()
        Visits the top page of this object.
      • visit

        public void visit​(String relativePath)
        Given the path relative to url, visit that page
      • url

        public URL url​(String rel)
        Resolves relative path against url and treats any exception a a fatal problem.
      • control

        public Control control​(String... relativePaths)
        Create a control object that wraps access to the specific INPUT element in this page area.

        The Control object itself can be created early as the actual element resolution happens lazily. This means PageAreaImpl implementations can put these in their fields.

        Several paths can be provided to find the first matching element. Useful when element path changed between versions.

      • control

        public Control control​(org.openqa.selenium.By selector)
      • createPageArea

        public String createPageArea​(String pathPrefix,
                                     Runnable action)
                              throws org.openqa.selenium.TimeoutException
        Capture path attribute of newly created form chunk upon invoking action.

        Consider "Add" button in page area with path "/foo" that is supposed to create new page area with path "/foo/bar" or "/foo/bar[n]". There are several problems with the straightforward approach: - Created area may or may not be the first one of its kind so figuring the "path" is nontrivial. - The area may can take a while to render so waiting is needed. - Even after the markup appears, it can take a while for "path" attribute is added.

        This method properly wait until the new path is known. To be used as:

          String barPath = fooArea.createPageArea("/bar", () -> control("add-button").click());
          new FooBarArea(fooArea, barPath);
        pathPrefix - Prefix of the expected path. The path is always absolute.
        action - An action that triggers the page area creation. Clicking the button, etc.
        The surrounding path of the area, exception thrown when not able to find out.