selenium-webdriver 0.0.24 → 0.0.25

data/firefox/src/extension/chrome.manifest

@@ -1,3 +0,0 @@
-content	fxdriver	content/  xpcnativewrappers=yes
-
-overlay	chrome://browser/content/browser.xul	chrome://fxdriver/content/fxdriver.xul

data/firefox/src/extension/components/badCertListener.js

@@ -1,295 +0,0 @@
-/*
- Copyright 2007-2009 WebDriver committers
- Copyright 2007-2009 Google Inc.
- Portions copyright 2007 ThoughtWorks, Inc
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- */
-
-/**
- * @fileOverview Contains a Javascript implementation for
- * a custom nsICertOverrideService. This class will forward requests to the
- * original certificate override service - unless it was told to accept all
- * of them.
- */
-
-const CC = Components.classes;
-const CI = Components.interfaces;
-
-const CONSOLE = CC["@mozilla.org/consoleservice;1"].
-                  getService(CI["nsIConsoleService"]);
-
-function localdump(message) {
-  try {
-    CONSOLE.logStringMessage(message + "\n");
-  } catch (e) {
-    dump(message + "\n");
-  }
-}
-
-function getPreferenceFromProfile(prefName, prefDefaultValue) {
-  var prefs =
-      CC["@mozilla.org/preferences-service;1"].getService(CI["nsIPrefBranch"]);
-
-  if (!prefs.prefHasUserValue(prefName)) {
-    localdump(prefName + ' not set; defaulting to ' + prefDefaultValue);
-    return prefDefaultValue;
-  }
-
-  var prefValue = prefs.getBoolPref(prefName);
-  localdump("Found preference for " + prefName + ": " + prefValue);
-
-  return prefValue;
-}
-
-function shouldAcceptUntrustedCerts() {
-  return getPreferenceFromProfile("webdriver_accept_untrusted_certs", true);
-}
-
-function shouldAssumeUntrustedIssuer() {
-  return getPreferenceFromProfile("webdriver_assume_untrusted_issuer", true);
-}
-
-function WdCertOverrideService() {
-  // Defaults to true - accepting untrusted certificates.
-  // This puts the module into effect - setting it to false
-  // will delegate all calls to the original service.
-  this.acceptAll = shouldAcceptUntrustedCerts();
-
-  // If untrusted issuer is set to false by the user,
-  // the initial bitmask will not include ERROR_UNTRUSTED.
-  //
-  // See the javadoc for FirefoxProfile and documentation
-  // for fillNeededBits for further explanation.
-  var untrusted_issuer = shouldAssumeUntrustedIssuer();
-  if (untrusted_issuer) {
-    this.default_bits = this.ERROR_UNTRUSTED;
-  } else {
-    this.default_bits = 0;
-  }
-
-  localdump("Accept untrusted certificates: " + this.acceptAll);
-
-  // UUID of the original implementor of this service.
-  var ORIGINAL_OVERRIDE_SERVICE_ID = "{67ba681d-5485-4fff-952c-2ee337ffdcd6}";
-
-  // Keep a reference to the original bad certificate listener.
-  var originalService = Components.classesByID[ORIGINAL_OVERRIDE_SERVICE_ID].
-      getService();
-
-  this.origListener_ =
-      originalService.QueryInterface(
-        Components.interfaces.nsICertOverrideService);
-};
-
-// Constants needed since WdCertOverrideService implements
-// nsICertOverrideService
-WdCertOverrideService.prototype = {
-  ERROR_UNTRUSTED: 1,
-  ERROR_MISMATCH: 2,
-  ERROR_TIME: 4
-};
-
-// Returns the bit needed to mask if the certificate has expired, 0 otherwise.
-WdCertOverrideService.prototype.certificateExpiredBit_ = function
-  (theCert, verification_result) {
-  if ((verification_result & theCert.CERT_EXPIRED) != 0) {
-    localdump("Certificate expired.");
-    return this.ERROR_TIME;
-  }
-
-  return 0;
-}
-
-// Returns the bit needed to mask untrusted issuers, 0 otherwise.
-// Note that this bit is already set by default in default_bits
-WdCertOverrideService.prototype.certificateIssuerUntrusted_ = function
-  (theCert, verification_result) {
-  if (((verification_result & theCert.ISSUER_UNKNOWN) != 0) ||
-      ((verification_result & theCert.ISSUER_NOT_TRUSTED) != 0) ||
-      ((verification_result & theCert.CERT_NOT_TRUSTED) != 0) ||
-      ((verification_result & theCert.INVALID_CA) != 0)) {
-    localdump("Certificate issuer unknown.");
-    return this.ERROR_UNTRUSTED;
-  }
-
-  return 0;
-}
-
-// Returns the bit needed to mask mismatch between actual hostname
-// and the hostname the certificate was issued for, 0 otherwise.
-WdCertOverrideService.prototype.certificateHostnameMismatch_ = function
-  (theCert, aHost) {
-  commonNameRE = new RegExp(theCert.commonName.replace('*', '\\w+'));
-  if (aHost.match(commonNameRE) === null) {
-    localdump("Host name mismatch: cert: " + theCert.commonName + " get: " + aHost);
-    return this.ERROR_MISMATCH;
-  }
-
-  return 0;
-}
-
-// Given a certificate and the host it was received for, fill in the bits
-// needed to accept this certificate for this host, even though the 
-// certificate is invalid.
-//
-// Note that the bitmask has to be accurate: At the moment, Firefox expects
-// the returned bitmask to match *exactly* to the errors the certificate
-// caused. If extra bits will be set, the untrusted certificate screen
-// will appear.
-WdCertOverrideService.prototype.fillNeededBits = function(aCert, aHost) {
-  var verification_bits = aCert.verifyForUsage(aCert.CERT_USAGE_SSLClient);
-  var return_bits = this.default_bits;
-
-  localdump("Certificate verification results: " + verification_bits);
-
-  return_bits = return_bits | this.certificateExpiredBit_(
-      aCert, verification_bits);
-  return_bits = return_bits | this.certificateIssuerUntrusted_(
-      aCert, verification_bits);
-  return_bits = return_bits | this.certificateHostnameMismatch_(aCert, aHost);
-  localdump("return_bits now: " + return_bits);
-  return return_bits;
-};
-
-// Interface functions from now on.
-WdCertOverrideService.prototype.hasMatchingOverride = function(
-    aHostName, aPort, aCert, aOverrideBits, aIsTemporary) {
-  var retval = false;
-
-  if (this.acceptAll === true) {
-    localdump("Allowing certificate from site: " + aHostName + ":" + aPort);
-    retval = true;
-    aIsTemporary.value = false;
-
-    aOverrideBits.value = this.fillNeededBits(aCert, aHostName);
-    localdump("Override Bits: " + aOverrideBits.value);
-  } else {
-    retval = this.origListener_.hasMatchingOverride(aHostName, aPort,
-              aCert, aOverrideBits, aIsTemporary);
-  }
-
-  return retval;
-};
-
-// Delegate the rest of the functions - they are not interesting as they are not
-// called during validation of invalid certificate normally.
-WdCertOverrideService.prototype.clearValidityOverride = function(aHostName,
-                                                                 aPort) {
-  this.origListener_.clearValidityOverride(aHostName, aPort);
-};
-
-WdCertOverrideService.prototype.getAllOverrideHostsWithPorts = function(
-    aCount, aHostsWithPortsArray) {
-  this.origListener_.getAllOverrideHostsWithPorts(aCert, aHostsWithPortsArray);
-};
-
-WdCertOverrideService.prototype.getValidityOverride = function(
-    aHostName, aPort, aHashAlg, aFingerprint, aOverrideBits, aIsTemporary) {
-  return this.origListener_.getValidityOverride(
-      aHostName, aPort, aHashAlg, aFingerprint, aOverrideBits, aIsTemporary);
-};
-
-WdCertOverrideService.prototype.isCertUsedForOverrides = function(
-    aCert, aCheckTemporaries, aCheckPermanents) {
-  return this.origListener_.isCertUsedForOverrides(
-      aCert, aCheckTemporaries, aCheckPermanents);
-};
-
-WdCertOverrideService.prototype.rememberValidityOverride = function(
-    aHostName, aPort, aCert, aOverrideBits, aTemporary) {
-  this.origListener_.rememberValidityOverride(
-      aHostName, aPort, aCert, aOverrideBits, aTemporary);
-};
-
-WdCertOverrideService.prototype.QueryInterface = function(aIID) {
-  if (aIID.equals(Components.interfaces.nsICertOverrideService) ||
-      aIID.equals(Components.interfaces.nsIInterfaceRequestor) ||
-      aIID.equals(Components.interfaces.nsISupports)) {
-    return this;
-  }
-
-  throw Components.results.NS_ERROR_NO_INTERFACE;
-}
-
-// Service contract ID which we override
-const CERTOVERRIDE_CONTRACT_ID = "@mozilla.org/security/certoverride;1";
-// UUID for this instance specifically.
-const DUMMY_CERTOVERRIDE_SERVICE_CLASS_ID =
-  Components.ID('{c8fffaba-9b7a-41aa-872d-7e7366c16715}');
-
-var service = undefined;
-
-var WDCertOverrideFactory = {
-  createInstance: function (aOuter, aIID) {
-    if (aOuter != null)
-      throw Components.results.NS_ERROR_NO_AGGREGATION;
-    if (service == undefined) {
-      service = new WdCertOverrideService();
-    }
-    return service;
-  }
-};
-
-function WDBadCertListenerModule() {
-  this.firstTime_ = true;
-}
-
-WDBadCertListenerModule.prototype.registerSelf = function(
-    aCompMgr, aFileSpec, aLocation, aType) {
-
-  if (this.firstTime_) {
-    this.firstTime_ = false;
-    throw Components.results.NS_ERROR_FACTORY_REGISTER_AGAIN;
-  }
-
-  localdump("Registering Override Certificate service.");
-  aCompMgr = aCompMgr.QueryInterface(
-      Components.interfaces.nsIComponentRegistrar);
-  aCompMgr.registerFactoryLocation(
-      DUMMY_CERTOVERRIDE_SERVICE_CLASS_ID, "WebDriver Override Cert Service",
-      CERTOVERRIDE_CONTRACT_ID, aFileSpec, aLocation, aType);
-};
-
-WDBadCertListenerModule.prototype.unregisterSelf = function(
-    aCompMgr, aLocation, aType) {
-  localdump("Un-registering Override Certificate service.");
-  aCompMgr =
-  aCompMgr.QueryInterface(Components.interfaces.nsIComponentRegistrar);
-  aCompMgr.unregisterFactoryLocation(DUMMY_CERTOVERRIDE_SERVICE_CLASS_ID, aLocation);
-};
-
-WDBadCertListenerModule.prototype.getClassObject = function(
-    aCompMgr, aCID, aIID) {
-  if (!aIID.equals(Components.interfaces.nsIFactory))
-    throw Components.results.NS_ERROR_NOT_IMPLEMENTED;
-
-  if (aCID.equals(DUMMY_CERTOVERRIDE_SERVICE_CLASS_ID))
-    return WDCertOverrideFactory;
-
-  throw Components.results.NS_ERROR_NO_INTERFACE;
-};
-
-WDBadCertListenerModule.prototype.canUnload = function(aCompMgr) {
-  return true;
-};
-
-function NSGetModule(comMgr, fileSpec) {
-  var appInfo = Components.classes['@mozilla.org/xre/app-info;1'].
-    getService(Components.interfaces.nsIXULAppInfo);
-  var versionChecker = Components.classes['@mozilla.org/xpcom/version-comparator;1'].
-    getService(Components.interfaces.nsIVersionComparator);
-  if (versionChecker.compare(appInfo.version, '3.0') >= 0) {
-    return new WDBadCertListenerModule();
-  }
-}

data/firefox/src/extension/components/dispatcher.js

@@ -1,495 +0,0 @@
-/*
- Copyright 2007-2010 WebDriver committers
- Copyright 2007-2010 Google Inc.
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- */
-
-
-/**
- * Dispatches commands received by the WebDriver server.
- * @constructor
- */
-function Dispatcher() {
-  this.resources_ = [];
-  this.init_();
-}
-
-
-/**
- * Utility function used to respond to a command that is recognised, but not
- * implemented. Returns a 501.
- * @param {Request} The request to respond to.
- * @param {Response} Class used to send the response.
- */
-Dispatcher.notImplemented = function(request, response) {
-  response.sendError(Response.NOT_IMPLEMENTED, 'Unsupported command',
-      'text/plain');
-};
-
-
-/**
- * Returns a function that translates a WebDriver HTTP request to a legacy
- * command.
- * @param {string} name The legacy command name.
- * @return {function(Request, Response)} The translation function.
- * @private
- */
-Dispatcher.executeAs = function(name) {
-  return function(request, response) {
-    var json = {
-      'name': name,
-      'sessionId': {
-        'value': request.getAttribute('sessionId') 
-      },
-      'parameters': JSON.parse(request.getBody() || '{}')
-    };
-
-    // All request attributes, excluding sessionId and parameters also passed
-    // the body payload, should be added to the parameters.
-    var attributeNames = request.getAttributeNames();
-    for (var attrName; attrName = attributeNames.shift();) {
-      if (attrName != 'sessionId' && !json['parameters'][attrName]) {
-        json['parameters'][attrName] = request.getAttribute(attrName);
-      }
-    }
-
-    var jsonString = JSON.stringify(json);
-    var callback = function(jsonResponseString) {
-      var jsonResponse = JSON.parse(jsonResponseString);
-      // Going to need more granularity here I think.
-      if (jsonResponse.status != ErrorCode.SUCCESS) {
-        response.setStatus(Response.INTERNAL_ERROR);
-      }
-
-      response.setContentType('application/json');
-      response.setBody(jsonResponseString);
-      response.commit();
-    };
-
-    // Dispatch the command.
-    Components.classes['@googlecode.com/webdriver/command-processor;1'].
-        getService(Components.interfaces.nsICommandProcessor).
-        execute(jsonString, callback);
-  };
-};
-
-
-/**
- * Creates a special handler for translating a request for a new session to a
- * request understood by the legacy nsICommandProcessor.
- */
-Dispatcher.translateNewSession = function() {
-  return function(request, response) {
-    var callback = function(jsonResponseString) {
-      var jsonResponse = JSON.parse(jsonResponseString);
-      // Going to need more granularity here I think.
-      if (jsonResponse.status != 0) {
-        response.sendError(Response.INTERNAL_ERROR,
-            jsonResponseString, 'application/json');
-      } else {
-        var url = request.getRequestUrl();
-        response.setStatus(Response.SEE_OTHER);
-        response.setHeader('Location',
-            url.scheme + '://' + url.hostPort + url.path + '/' +
-                jsonResponse.value);
-        response.commit();
-      }
-    };
-
-    // Dispatch the command.
-    Components.classes['@googlecode.com/webdriver/command-processor;1'].
-        getService(Components.interfaces.nsICommandProcessor).
-        execute('{"name":"newSession"}', callback);
-  };
-};
-
-
-/**
- * Initializes the command bindings for this dispatcher.
- * @private
- */
-Dispatcher.prototype.init_ = function() {
-  this.bind_('/config/drivers').  // Recognised, but not supported.
-      on(Request.Method.POST, Dispatcher.notImplemented);
-
-  this.bind_('/session').
-      on(Request.Method.POST, Dispatcher.translateNewSession());
-
-  this.bind_('/session/:sessionId').
-      on(Request.Method.GET, Dispatcher.executeAs('getSessionCapabilities')).
-      on(Request.Method.DELETE, Dispatcher.executeAs('quit'));
-
-  this.bind_('/session/:sessionId/window_handle').
-      on(Request.Method.GET, Dispatcher.executeAs('getCurrentWindowHandle'));
-  this.bind_('/session/:sessionId/window_handles').
-      on(Request.Method.GET, Dispatcher.executeAs('getWindowHandles'));
-
-  this.bind_('/session/:sessionId/speed').
-      on(Request.Method.GET, Dispatcher.executeAs('getSpeed')).
-      on(Request.Method.POST, Dispatcher.executeAs('setSpeed'));
-
-  this.bind_('/session/:sessionId/timeouts/implicit_wait').
-      on(Request.Method.POST, Dispatcher.executeAs('implicitlyWait'));
-
-  this.bind_('/session/:sessionId/url').
-      on(Request.Method.GET, Dispatcher.executeAs('getCurrentUrl')).
-      on(Request.Method.POST, Dispatcher.executeAs('get'));
-
-  this.bind_('/session/:sessionId/forward').
-      on(Request.Method.POST, Dispatcher.executeAs('goForward'));
-  this.bind_('/session/:sessionId/back').
-      on(Request.Method.POST, Dispatcher.executeAs('goBack'));
-  this.bind_('/session/:sessionId/refresh').
-      on(Request.Method.POST, Dispatcher.executeAs('refresh'));
-
-  this.bind_('/session/:sessionId/execute').
-      on(Request.Method.POST, Dispatcher.executeAs('executeScript'));
-
-  this.bind_('/session/:sessionId/source').
-      on(Request.Method.GET, Dispatcher.executeAs('getPageSource'));
-  this.bind_('/session/:sessionId/title').
-      on(Request.Method.GET, Dispatcher.executeAs('getTitle'));
-
-  this.bind_('/session/:sessionId/element').
-      on(Request.Method.POST, Dispatcher.executeAs('findElement'));
-  this.bind_('/session/:sessionId/elements').
-      on(Request.Method.POST, Dispatcher.executeAs('findElements'));
-  this.bind_('/session/:sessionId/element/active').
-      on(Request.Method.POST, Dispatcher.executeAs('getActiveElement'));
-
-  this.bind_('/session/:sessionId/element/:id').
-      // TODO: implement
-      on(Request.Method.GET, Dispatcher.notImplemented);
-
-  this.bind_('/session/:sessionId/element/:id/element').
-      on(Request.Method.POST, Dispatcher.executeAs('findChildElement'));
-  this.bind_('/session/:sessionId/element/:id/elements').
-      on(Request.Method.POST, Dispatcher.executeAs('findChildElements'));
-
-  this.bind_('/session/:sessionId/element/:id/click').
-      on(Request.Method.POST, Dispatcher.executeAs('clickElement'));
-  this.bind_('/session/:sessionId/element/:id/text').
-      on(Request.Method.GET, Dispatcher.executeAs('getElementText'));
-  this.bind_('/session/:sessionId/element/:id/submit').
-      on(Request.Method.POST, Dispatcher.executeAs('submitElement'));
-
-  this.bind_('/session/:sessionId/element/:id/value').
-      on(Request.Method.POST, Dispatcher.executeAs('sendKeysToElement')).
-      on(Request.Method.GET, Dispatcher.executeAs('getElementValue'));
-
-  this.bind_('/session/:sessionId/element/:id/name').
-      on(Request.Method.GET, Dispatcher.executeAs('getElementTagName'));
-
-  this.bind_('/session/:sessionId/element/:id/clear').
-      on(Request.Method.POST, Dispatcher.executeAs('clearElement'));
-
-  this.bind_('/session/:sessionId/element/:id/selected').
-      on(Request.Method.GET, Dispatcher.executeAs('isElementSelected')).
-      on(Request.Method.POST, Dispatcher.executeAs('setElementSelected'));
-
-  this.bind_('/session/:sessionId/element/:id/enabled').
-      on(Request.Method.GET, Dispatcher.executeAs('isElementEnabled'));
-  this.bind_('/session/:sessionId/element/:id/displayed').
-      on(Request.Method.GET, Dispatcher.executeAs('isElementDisplayed'));
-
-  this.bind_('/session/:sessionId/element/:id/location').
-      on(Request.Method.GET, Dispatcher.executeAs('getElementLocation'));
-  this.bind_('/session/:sessionId/element/:id/location_in_view').
-      on(Request.Method.GET, Dispatcher.executeAs(
-          'getElementLocationOnceScrolledIntoView'));
-
-  this.bind_('/session/:sessionId/element/:id/size').
-      on(Request.Method.GET, Dispatcher.executeAs('getElementSize'));
-
-  this.bind_('/session/:sessionId/element/:id/css/:propertyName').
-      on(Request.Method.GET,
-         Dispatcher.executeAs('getElementValueOfCssProperty'));
-  this.bind_('/session/:sessionId/element/:id/attribute/:name').
-      on(Request.Method.GET, Dispatcher.executeAs('getElementAttribute'));
-  this.bind_('/session/:sessionId/element/:id/equals/:other').
-      on(Request.Method.GET, Dispatcher.executeAs('elementEquals'));
-
-  this.bind_('/session/:sessionId/element/:id/toggle').
-      on(Request.Method.POST, Dispatcher.executeAs('toggleElement'));
-  this.bind_('/session/:sessionId/element/:id/hover').
-      on(Request.Method.POST, Dispatcher.executeAs('hoverOverElement'));
-  this.bind_('/session/:sessionId/element/:id/drag').
-      on(Request.Method.POST, Dispatcher.executeAs('dragElement'));
-
-  this.bind_('/session/:sessionId/cookie').
-      on(Request.Method.GET, Dispatcher.executeAs('getCookies')).
-      on(Request.Method.POST, Dispatcher.executeAs('addCookie')).
-      on(Request.Method.DELETE, Dispatcher.executeAs('deleteAllCookies'));
-
-  this.bind_('/session/:sessionId/cookie/:name').
-      on(Request.Method.DELETE, Dispatcher.executeAs('deleteCookie'));
-
-  this.bind_('/session/:sessionId/frame').
-      on(Request.Method.POST, Dispatcher.executeAs('switchToFrame'));
-  this.bind_('/session/:sessionId/window').
-      on(Request.Method.POST, Dispatcher.executeAs('switchToWindow')).
-      on(Request.Method.DELETE, Dispatcher.executeAs('close'));
-
-  this.bind_('/session/:sessionId/screenshot').
-      on(Request.Method.GET, Dispatcher.executeAs('screenshot'));
-
-
-  // --------------------------------------------------------------------------
-  // Firefox extensions to the wire protocol.
-  // --------------------------------------------------------------------------
-
-  this.bind_('/extensions/firefox/quit').
-      on(Request.Method.POST, Dispatcher.executeAs('quit'));
-};
-
-
-/**
- * Binds a resource to the given path.
- * @param {string} path The resource path.
- * @return {Resource} The bound resource.
- */
-Dispatcher.prototype.bind_ = function(path) {
-  var resource = new Resource(path);
-  this.resources_.push(resource);
-  return resource;
-};
-
-
-
-/**
- * Dispatches a request to the appropriately registered handler.
- * @param {Request} request The request to dispatch.
- * @param {Response} response The request response.
- */
-Dispatcher.prototype.dispatch = function(request, response) {
-  // We only support one servlet, mapped to /hub/*
-  // TODO: be more flexible.
-  var path = request.getRequestUrl().path;
-  if (path.indexOf('/hub') != 0) {
-    response.sendError(Response.NOT_FOUND);
-    return;
-  }
-  request.setServletPath('/hub');
-  path = request.getPathInfo();
-
-  var bestMatchResource;
-  for (var i = 0; i < this.resources_.length; i++) {
-    if (this.resources_[i].isResourceFor(path)) {
-      if (!bestMatchResource ||
-          bestMatchResource.getNumVariablePathSegments() <
-          this.resources_[i].getNumVariablePathSegments()) {
-        bestMatchResource = this.resources_[i];
-      }
-    }
-  }
-
-  if (bestMatchResource) {
-    try {
-      bestMatchResource.setRequestAttributes(request);
-      bestMatchResource.handle(request, response);
-    } catch (ex) {
-      Utils.dump(ex);
-      response.sendError(Response.INTERNAL_ERROR, JSON.stringify({
-        status: ErrorCode.UNHANDLED_ERROR,
-        value: ErrorCode.toJSON(ex)
-      }), 'application/json');
-    }
-  } else {
-    response.sendError(Response.NOT_FOUND,
-        'Unrecognized command: ' + request.getMethod() + ' ' +
-            request.getPathInfo(),
-        'text/plain');
-  }
-};
-
-
-/**
- * Defines a resource in the WebDriver REST service locatable at the given path.
- * Any path segments prefixed with a ":" indicate that segment is a variable
- * unique to a resource. For example, in the path "/session/:sessionId",
- * ":sessionId" is a variable that can be changed to specify different sessions.
- * @param {!string} path The path that this resource is accessible from.
- */
-function Resource(path) {
-
-  /**
-   * The request pattern that this resource is located at.
-   * @type {!string}
-   * @const
-   * @private
-   */
-  this.path_ = path;
-
-  /**
-   * The individual path segments for this resource.
-   * @type {Array.<string>}
-   * @const
-   * @private
-   */
-  this.pathSegments_ = path.split('/');
-
-  /**
-   * A map of handler functions, by HTTP method, that can service requests to
-   * this resource.
-   * @type {!Object}
-   * @const
-   * @private
-   */
-  this.handlers_ = {};
-
-  for (var i = 0; i < this.pathSegments_.length; i++) {
-    if (this.pathSegments_[i].indexOf(Resource.VARIABLE_PATH_SEGMENT_PREFIX_)) {
-      this.numVariablePathSegments_ += 1;
-    }
-  }
-};
-
-
-/**
- * The number of path segments for this resource that are variables.
- * @type {number}
- * @private
- */
-Resource.prototype.numVariablePathSegments_ = 0;
-
-
-/** @return {string} The path mapped to this resource. */
-Resource.prototype.getPath = function() {
-  return this.path_;
-};
-
-
-/** @return {number} The number of variable path segments for this resource. */
-Resource.prototype.getNumVariablePathSegments = function() {
-  return this.numVariablePathSegments_;
-};
-
-
-/**
- * Sets the handler function for this resource when a request is received using
- * the given HTTP method. This function will override any previously set
- * handlers.
- * @param {!Request.Method} httpMethod The request method the function can
- *     handle.
- * @param {function(Request, Response)} handlerFn The function that will handle
- *     all requests for this resource using the given HTTP method.
- * @return {!Resource} A self reference for chained calls.
- */
-Resource.prototype.on = function(httpMethod, handlerFn) {
-  this.handlers_[httpMethod] = handlerFn;
-  return this;
-};
-
-
-/**
- * Determines if this is the resource for the given path.
- * @param {!string} path The resource path to test.
- * @return {boolean} Whether this resource is mapped to the given path.
- */
-Resource.prototype.isResourceFor = function(path) {
-  var allParts = path.split('/');
-  if (this.pathSegments_.length != allParts.length) {
-    return false;
-  }
-  for (var i = 0; i < this.pathSegments_.length; i++) {
-    if (this.pathSegments_[i] != allParts[i] &&
-        !/^:/.test(this.pathSegments_[i])) {
-      return false;
-    }
-  }
-  return true;
-};
-
-
-/**
- * Sets request attributes by the named path variables for this resource. For
- * each named path segment variable for this resource, the value of the
- * corresponding path segment in the request will be stored as the request
- * attribute's value.
- * @param {Request} request The request to update.
- */
-Resource.prototype.setRequestAttributes = function(request) {
-  var allParts = request.getPathInfo().split('/');
-  for (var i = 0; i < this.pathSegments_.length; i++) {
-    if (/^:/.test(this.pathSegments_[i])) {
-      var decodedValue = decodeURIComponent(allParts[i]);
-      request.setAttribute(
-          this.pathSegments_[i].replace(/^:/, ''), decodedValue);
-    }
-  }
-};
-
-
-/**
- * Handles a request to this resource. Will return a 405 if this resource does
- * not permit the HTTP method used for the request.
- * @param {Request} request The request to handle.
- * @param {Response} response For sending the response.
- * @throws If this resource cannot handle the request.
- */
-Resource.prototype.handle = function(request, response) {
-  if (!this.isResourceFor(request.getPathInfo())) {
-    throw Error('Request does not map to this resource:' +
-        '\n  requestPath:  ' + request.getPathInfo() +
-        '\n  resourcePath: ' + this.path_);;
-  }
-
-  var requestMethod = request.getMethod();
-
-  if (requestMethod == Request.Method.OPTIONS) {
-    response.setHeader('Allow', this.getAllowedMethods_());
-    response.setStatus(Response.OK);
-    response.setBody('');
-    response.commit();
-    return;
-  }
-
-  if (requestMethod == Request.Method.HEAD) {
-    requestMethod = Request.Method.GET;
-  }
-
-  var handlerFn = this.handlers_[requestMethod];
-  if (handlerFn) {
-    handlerFn(request, response);
-  } else {
-    response.setHeader('Allow', this.getAllowedMethods_());
-    response.setContentType('text/plain');
-    response.sendError(Response.METHOD_NOT_ALLOWED,
-        'Method "' + request.getMethod() + '" not allowed for command ' +
-            '"' + this.path_ + '"');
-  }
-};
-
-
-/**
- * @return {string} A comma-delimitted list of HTTP methods allowed by this
- *     resource.
- * @private
- */
-Resource.prototype.getAllowedMethods_ = function() {
-  var allowed = [];
-  for (var method in this.handlers_) {
-    allowed.push(method);
-  }
-
-  // We always respond to OPTIONS
-  allowed.push(Request.Method.OPTIONS);
-
-  // If we respond to GET, then we respond to HEAD.
-  if (Request.Method.GET in this.handlers_) {
-    allowed.push(Request.Method.HEAD);
-  }
-
-  return allowed.join(',');
-};