appium-webdriveragent 16.0.3 → 16.1.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [16.1.0](https://github.com/appium/WebDriverAgent/compare/v16.0.3...v16.1.0) (2026-07-30)
+
+### Features
+
+* Add callback for server startup failure ([#1192](https://github.com/appium/WebDriverAgent/issues/1192)) ([3a80439](https://github.com/appium/WebDriverAgent/commit/3a80439603a45321ad8d238186b6327bb2599a8b))
+
 ## [16.0.3](https://github.com/appium/WebDriverAgent/compare/v16.0.2...v16.0.3) (2026-07-28)
 
 ### Miscellaneous Chores

package/WebDriverAgentLib/Info.plist

@@ -15,11 +15,11 @@
     <key>CFBundlePackageType</key>
     <string>FMWK</string>
     <key>CFBundleShortVersionString</key>
-    <string>16.0.3</string>
+    <string>16.1.0</string>
     <key>CFBundleSignature</key>
     <string>????</string>
     <key>CFBundleVersion</key>
-    <string>16.0.3</string>
+    <string>16.1.0</string>
     <key>NSPrincipalClass</key>
     <string/>
   </dict>

package/WebDriverAgentLib/Routing/FBWebServer.h

@@ -24,7 +24,11 @@ NS_ASSUME_NONNULL_BEGIN
 @property (weak, nonatomic) id<FBWebServerDelegate> delegate;
 
 /**
- Starts WebDriverAgent service by booting HTTP and USB server
+ Starts WebDriverAgent service by booting HTTP and USB server.
+ If the HTTP server fails to bind (for example the whole configured port range
+ is already occupied), the failure is reported to the delegate via
+ `webServer:didFailToStartWithError:`. If the delegate does not implement that
+ method the process is aborted, as before.
  */
 - (void)startServing;
 
@@ -47,6 +51,18 @@ NS_ASSUME_NONNULL_BEGIN
  */
 - (void)webServerDidRequestShutdown:(FBWebServer *)webServer;
 
+@optional
+/**
+ Called when the server failed to start the HTTP listener, for example because
+ none of the ports in the configured binding range could be bound.
+ If this method is not implemented by the delegate then the process is aborted,
+ preserving the previous behavior.
+
+ @param webServer Server instance.
+ @param error The actual error, that caused the server startup to fail.
+ */
+- (void)webServer:(FBWebServer *)webServer didFailToStartWithError:(NSError *)error;
+
 @end
 
 NS_ASSUME_NONNULL_END

package/WebDriverAgentLib/Routing/FBWebServer.m

@@ -81,7 +81,9 @@ static NSString *const FBServerURLEndMarker = @"<-ServerURLHere";
 {
   [FBLogger logFmt:@"Built at %s %s", __DATE__, __TIME__];
   self.exceptionHandler = [FBExceptionHandler new];
-  [self startHTTPServer];
+  if (![self startHTTPServer]) {
+    return;
+  }
   [self initScreenshotsBroadcaster];
 
   self.keepAlive = YES;
@@ -90,7 +92,7 @@ static NSString *const FBServerURLEndMarker = @"<-ServerURLHere";
          [runLoop runMode:NSDefaultRunLoopMode beforeDate:[NSDate distantFuture]]);
 }
 
-- (void)startHTTPServer
+- (BOOL)startHTTPServer
 {
   self.server = [[RoutingHTTPServer alloc] init];
   [self.server setRouteQueue:dispatch_get_main_queue()];
@@ -126,11 +128,16 @@ static NSString *const FBServerURLEndMarker = @"<-ServerURLHere";
 
   if (!serverStarted) {
     [FBLogger logFmt:@"Last attempt to start web server failed with error %@", [error description]];
+    if ([self.delegate respondsToSelector:@selector(webServer:didFailToStartWithError:)]) {
+      [self.delegate webServer:self didFailToStartWithError:(NSError * _Nonnull)error];
+      return NO;
+    }
     abort();
   }
 
   NSString *serverHost = bindingIP ?: ([XCUIDevice sharedDevice].fb_wifiIPAddress ?: @"127.0.0.1");
   [FBLogger logFmt:@"%@http://%@:%d%@", FBServerURLBeginMarker, serverHost, [self.server port], FBServerURLEndMarker];
+  return YES;
 }
 
 - (void)initScreenshotsBroadcaster

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-webdriveragent",
-  "version": "16.0.3",
+  "version": "16.1.0",
   "description": "Package bundling WebDriverAgent",
   "keywords": [
     "Appium",