org.openqa.selenium.server.browserlaunchers.BrowserStringParser Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of selenium-server

Selenium automates browsers. That's it! What you do with that power is entirely up to you.

There is a newer version: 3.9.1

package org.openqa.selenium.server.browserlaunchers;

import java.util.regex.Matcher;
import java.util.regex.Pattern;

/**
 * Parse a Selenium browser string to extract browserStartCommand if there is one.
 */
public class BrowserStringParser {

  public class Result {

    private boolean match;
    private String customLauncher;

    public Result(boolean match, String customLauncher) {
      this.match = match;
      this.customLauncher = customLauncher;
    }

    public Result(boolean match) {
      this(match, null);
    }

    public boolean match() {
      return match;
    }

    public String customLauncher() {
      return this.customLauncher;
    }

  }

  /**
   * Returns the browser start command, if any, for the browser in the 'browserString' parameter. If
   * the browserString cannot be matched to the 'knownBrowser' parameter, an illegal argument
   * exception is thrown.
   * 
   * @param browserIdentifier a known browser identifier.
   * @param userBrowserSpecification the string sent by the client to identify the type of browser
   *        to start, e.g. *firefox
   * @return Match result, never null.
   */
  public Result parseBrowserStartCommand(String browserIdentifier, String userBrowserSpecification) {
    final Pattern pattern;
    final Matcher matcher;
    final String customLauncher;

    pattern = Pattern.compile("^\\*?" + browserIdentifier + "\\s*(\\s(.*))?$");
    matcher = pattern.matcher(userBrowserSpecification);
    if (!matcher.find()) {
      return new Result(false);
    }

    if (matcher.group(2) == null || "".equals(matcher.group(2).trim())) {
      customLauncher = null;
    } else {
      customLauncher = matcher.group(2).trim();
    }
    return new Result(true, ("".equals(customLauncher)) ? null : customLauncher);
  }

}