[js] For consistency, InvalidSessionIdError -> NoSuchSessionError

Author: jleyba

javascript/node/selenium-webdriver/CHANGES.md

@@ -11,6 +11,8 @@
 
       driver.findElements(By.css('.foo')).then(found => !!found.length);
 * Added support for W3C-spec compliant servers.
+* For consistent naming, deprecating `error.InvalidSessionIdError` in favor of
+    `error.NoSuchSessionError`.
 
 ### Changes for W3C WebDriver Spec Compliance
 

javascript/node/selenium-webdriver/error.js

@@ -160,10 +160,20 @@ class InvalidSelectorError extends WebDriverError {
 
 
 /**
- * Occurs if the given session id is not in the list of active sessions, meaning
- * the session either does not exist or that it’s not active.
+ * Occurs when a command is directed to a session that does not exist.
  */
-class InvalidSessionIdError extends WebDriverError {
+class NoSuchSessionError extends WebDriverError {
+  /** @param {string=} opt_error the error message, if any. */
+  constructor(opt_error) {
+    super(opt_error);
+  }
+}
+
+
+/**
+ * @deprecated Use {@link NoSuchSessionError} instead.
+ */
+class InvalidSessionIdError extends NoSuchSessionError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
     super(opt_error);
@@ -521,7 +531,7 @@ const ERROR_CODE_TO_TYPE = new Map([
     ['invalid element coordinates', InvalidElementCoordinatesError],
     ['invalid element state', InvalidElementStateError],
     ['invalid selector', InvalidSelectorError],
-    ['invalid session id', InvalidSessionIdError],
+    ['invalid session id', NoSuchSessionError],
     ['javascript error', JavascriptError],
     ['move target out of bounds', MoveTargetOutOfBoundsError],
     ['no such alert', NoSuchAlertError],
@@ -630,6 +640,7 @@ exports.MoveTargetOutOfBoundsError = MoveTargetOutOfBoundsError;
 exports.NoSuchAlertError = NoSuchAlertError;
 exports.NoSuchElementError = NoSuchElementError;
 exports.NoSuchFrameError = NoSuchFrameError;
+exports.NoSuchSessionError = NoSuchSessionError;
 exports.NoSuchWindowError = NoSuchWindowError;
 exports.ScriptTimeoutError = ScriptTimeoutError;
 exports.SessionNotCreatedError = SessionNotCreatedError;

javascript/node/selenium-webdriver/lib/webdriver.js

@@ -356,7 +356,7 @@ class WebDriver {
 
     function checkHasNotQuit() {
       if (!self.session_) {
-        throw new error.UnsupportedOperationError(
+        throw new error.NoSuchSessionError(
           'This driver instance does not have a valid session ID ' +
           '(did you call WebDriver.quit()?) and may no longer be ' +
           'used.');

javascript/node/selenium-webdriver/test/error_test.js

@@ -46,7 +46,7 @@ describe('error', function() {
     test('invalid element coordinates', error.InvalidElementCoordinatesError);
     test('invalid element state', error.InvalidElementStateError);
     test('invalid selector', error.InvalidSelectorError);
-    test('invalid session id', error.InvalidSessionIdError);
+    test('invalid session id', error.NoSuchSessionError);
     test('javascript error', error.JavascriptError);
     test('move target out of bounds', error.MoveTargetOutOfBoundsError);
     test('no such alert', error.NoSuchAlertError);
@@ -119,7 +119,7 @@ describe('error', function() {
     test('invalid element coordinates', error.InvalidElementCoordinatesError);
     test('invalid element state', error.InvalidElementStateError);
     test('invalid selector', error.InvalidSelectorError);
-    test('invalid session id', error.InvalidSessionIdError);
+    test('invalid session id', error.NoSuchSessionError);
     test('javascript error', error.JavascriptError);
     test('move target out of bounds', error.MoveTargetOutOfBoundsError);
     test('no such alert', error.NoSuchAlertError);
@@ -243,7 +243,7 @@ describe('error', function() {
     check(error.InvalidElementCoordinatesError, 'INVALID_ELEMENT_COORDINATES');
     check(error.InvalidElementStateError, 'INVALID_ELEMENT_STATE');
     check(error.InvalidSelectorError, 'INVALID_SELECTOR_ERROR');
-    check(error.InvalidSessionIdError, 'UNKNOWN_ERROR');
+    check(error.NoSuchSessionError, 'UNKNOWN_ERROR');
     check(error.JavascriptError, 'JAVASCRIPT_ERROR');
     check(error.MoveTargetOutOfBoundsError, 'MOVE_TARGET_OUT_OF_BOUNDS');
     check(error.NoSuchAlertError, 'NO_SUCH_ALERT');

javascript/node/selenium-webdriver/test/lib/webdriver_test.js

@@ -485,7 +485,7 @@ describe('WebDriver', function() {
     driver.get('http://www.google.com');
     return waitForAbort().
         then(expectedError(
-            error.UnsupportedOperationError,
+            error.NoSuchSessionError,
             'This driver instance does not have a valid session ID ' +
             '(did you call WebDriver.quit()?) and may no longer be used.'));
   });