fix: fall back to standard error mapping in ErrorCodesMobile.getExceptionType(String)

getExceptionType(String) returned null for any state that is not a
mobile-specific error, while getExceptionType(int) delegates to super.
Selenium is moving ErrorHandler from the JSON Wire integer status to the
W3C state string (SeleniumHQ/selenium#18059), after which every standard
error (e.g. "no such element") would resolve to null and surface as a
plain WebDriverException instead of its specific type.

Delegate unmatched states to super, and guard against a null state.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: diemol

src/main/java/io/appium/java_client/ErrorCodesMobile.java

@@ -51,21 +51,22 @@ public Class<? extends WebDriverException> getExceptionType(int statusCode) {
     }
 
     /**
-     * Returns the exception type that corresponds to the given {@code message}or {@code null} if
-     * there are no matching mobile exceptions.
+     * Returns the exception type that corresponds to the given {@code message}. Messages that do not
+     * match a mobile exception are resolved by the standard W3C error mapping.
      *
      * @param message message An error message returned by Appium server
-     * @return The exception type that corresponds to the provided error message or {@code null} if
-     *     there are no matching mobile exceptions.
+     * @return The exception type that corresponds to the provided error message.
      */
     @Override
     public Class<? extends WebDriverException> getExceptionType(String message) {
-        for (Map.Entry<Integer, String> entry : statusToState.entrySet()) {
-            if (message.contains(entry.getValue())) {
-                return getExceptionType(entry.getKey());
+        if (message != null) {
+            for (Map.Entry<Integer, String> entry : statusToState.entrySet()) {
+                if (message.contains(entry.getValue())) {
+                    return getExceptionType(entry.getKey());
+                }
             }
         }
-        return null;
+        return super.getExceptionType(message);
     }
 
     /**

src/test/java/io/appium/java_client/ErrorCodesMobileTest.java

@@ -0,0 +1,30 @@
+package io.appium.java_client;
+
+import org.junit.jupiter.api.Test;
+import org.openqa.selenium.NoSuchElementException;
+import org.openqa.selenium.StaleElementReferenceException;
+import org.openqa.selenium.WebDriverException;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+class ErrorCodesMobileTest {
+    private final ErrorCodesMobile errorCodes = new ErrorCodesMobile();
+
+    @Test
+    void resolvesMobileExceptionFromMessage() {
+        assertEquals(NoSuchContextException.class, errorCodes.getExceptionType("No such context found"));
+    }
+
+    @Test
+    void resolvesStandardExceptionsFromW3cState() {
+        assertEquals(NoSuchElementException.class, errorCodes.getExceptionType("no such element"));
+        assertEquals(StaleElementReferenceException.class,
+                errorCodes.getExceptionType("stale element reference"));
+    }
+
+    @Test
+    void resolvesUnknownOrMissingStateToWebDriverException() {
+        assertEquals(WebDriverException.class, errorCodes.getExceptionType("not a real error"));
+        assertEquals(WebDriverException.class, errorCodes.getExceptionType((String) null));
+    }
+}