feat(net): getAvailablePort()

net/get_available_port.ts

@@ -0,0 +1,18 @@
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+
+/**
+ * Returns an available network port.
+ *
+ * @example
+ * ```ts
+ * import { getAvailablePort } from "https://deno.land/std@$STD_VERSION/net/get_available_port.ts";
+ *
+ * const port = getAvailablePort();
+ * Deno.serve({ port }, () => new Response("Hello, world!"));
+ * ```
+ */
+export function getAvailablePort(): number {
+ const listener = Deno.listen({ port: 0 });
+ listener.close();
+ return (listener.addr as Deno.NetAddr).port;
+}

net/get_available_port_test.ts

@@ -0,0 +1,20 @@
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+
+import { getAvailablePort } from "./get_available_port.ts";
+import { assertEquals } from "../assert/mod.ts";
+
+Deno.test("getAvailablePort() gets an available port", async () => {
+ const port = getAvailablePort();
+
+ const server = Deno.serve({
+ port,
+ async onListen() {
+ const resp = await fetch(`http:https://localhost:${port}`);
+ const text = await resp.text();
+ assertEquals(text, "hello");
+ server.shutdown();
+ },
+ }, () => new Response("hello"));
+
+ await server.finished;
+});

net/mod.ts

@@ -0,0 +1,9 @@
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+
+/**
+ * Network utilities.
+ *
+ * @module
+ */
+
+export * from "./get_available_port.ts";