socket-function 1.2.5 → 1.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "socket-function",
-	"version": "1.2.5",
+	"version": "1.2.6",
 	"main": "index.js",
 	"license": "MIT",
 	"dependencies": {

package/src/webSocketServer.ts

@@ -348,8 +348,19 @@ export async function startSocketServer(
         });
     }
 
-    let bound = await tryListen(port);
-    if (!bound && config.useAvailablePortIfPortInUse) {
+    let bound = false;
+    // Honor an explicitly requested port first. A falsy port (0, the default) means
+    //  "no preference" — skip straight to the scan so we land on a consistent port
+    //  instead of an OS-assigned random one.
+    if (port) {
+        bound = await tryListen(port);
+        if (!bound && !config.useAvailablePortIfPortInUse) {
+            throw new Error(`Port ${port} is already in use (set useAvailablePortIfPortInUse to fall back to another port)`);
+        }
+    }
+    // Scan upwards from PORT_SCAN_START for the first free port, so restarts land on
+    //  predictable ports.
+    if (!bound) {
         for (let candidate = PORT_SCAN_START; candidate < PORT_SCAN_START + PORT_SCAN_COUNT; candidate++) {
             if (candidate === port) continue;
             if (await tryListen(candidate)) {
@@ -362,9 +373,6 @@ export async function startSocketServer(
             throw new Error(`Could not find an available port in range ${PORT_SCAN_START}-${PORT_SCAN_START + PORT_SCAN_COUNT - 1} (requested ${config.port})`);
         }
     }
-    if (!bound) {
-        throw new Error(`Port ${port} is already in use (set useAvailablePortIfPortInUse to fall back to another port)`);
-    }
 
     port = (realServer.address() as net.AddressInfo).port;