spooder 6.1.93 → 6.1.94

package/README.md

@@ -599,6 +599,7 @@ log_list(input: any[], delimiter = ', ');
 
 // http
 http_serve(port: number, hostname?: string): Server;
+server.port: number;
 server.stop(immediate: boolean): Promise<void>;
 
 // cookies
@@ -840,13 +841,14 @@ IPC_TARGET.BROADCAST; // broadcast to all other instances
 ## API > HTTP
 
 ### `http_serve(port: number, hostname?: string): Server`
-Bootstrap a server on the specified port (and optional hostname).
+Bootstrap a server on the specified port (and optional hostname). Pass `0` for the port to assign a random available port, which can then be retrieved via `server.port`.
 
 ```ts
 import { serve } from 'spooder';
 
 const server = http_serve(8080); // port only
 const server = http_serve(3000, '0.0.0.0'); // optional hostname
+const server = http_serve(0); // random port, retrieve via server.port
 ```
 
 By default, the server responds with:
@@ -879,6 +881,15 @@ await server.stop(false);
 // do something now all connections are done
 ```
 
+### 📖 `server.port`
+
+Returns the port the server is listening on. Useful when `0` is passed to `http_serve()` for a random port assignment.
+
+```ts
+const server = http_serve(0);
+console.log(`Server listening on port ${server.port}`);
+```
+
 ### Routing
 
 ### 🔧 `server.route(path: string, handler: RequestHandler)`

package/package.json

@@ -2,7 +2,7 @@
 	"name": "spooder",
 	"author": "Kruithne <kruithne@gmail.com>",
 	"type": "module",
-	"version": "6.1.93",
+	"version": "6.1.94",
 	"module": "./src/api.ts",
 	"repository": {
 		"url": "https://github.com/Kruithne/spooder"

package/src/api.ts

@@ -1817,7 +1817,7 @@ export function http_serve(port: number, hostname?: string) {
 		}
 	});
 	
-	log_spooder(`server started on port {${port}} (host: {${hostname ?? 'unspecified'}})`);
+	log_spooder(`server started on port {${server.port}} (host: {${hostname ?? 'unspecified'}})`);
 	
 	type ThrottleHandler = {
 		(delta: number, handler: JSONRequestHandler): JSONRequestHandler;
@@ -2179,6 +2179,11 @@ export function http_serve(port: number, hostname?: string) {
 					return http_apply_range(file, request);
 				});
 			}
+		},
+
+		/** The port the server is listening on. Useful when port 0 is passed to assign a random port. */
+		get port(): number {
+			return server.port!;
 		}
 	};
 }