chore: export lockedPorts

index.d.ts

@@ -60,3 +60,29 @@ console.log(await getPort({port: portNumbers(3000, 3100)}));
 ```
 */
 export function portNumbers(from: number, to: number): Iterable<number>;
+
+/**
+Exporting `lockedPorts` allows for explicit management of port state, enabling developers to maintain application stability and avoid potential conflicts due to untrackable port allocations.
+ *
+@example
+```
+// Assuming `get-port` has been updated to export `lockedPorts`
+const getPort = require('get-port');
+const { lockedPorts } = require('get-port');
+
+async function getUniquePort() {
+
+  const port = await getPort();
+  console.log(port); // Outputs a free port
+  // do something
+  lockedPorts.old.clear(); // Reset/Clear the lockedPorts before use
+  lockedPorts.young.clear(); // Reset/Clear the lockedPorts before use
+  // Now, when getPort is called again, it considers all ports (excluding the system reserved)
+  // which means there's no inadvertent port "leakage" or unintended persisting of locked ports across calls.
+}
+```
+ **/
+export declare const lockedPorts: {
+	old: Set<number>;
+	young: Set<number>;
+};

index.js

@@ -7,7 +7,8 @@ class Locked extends Error {
 	}
 }
 
-const lockedPorts = {
+// Export variables to make them modifiable and clearable
+export const lockedPorts = {
 	old: new Set(),
 	young: new Set(),
 };

test.js

@@ -1,7 +1,7 @@
 import {promisify} from 'node:util';
 import net from 'node:net';
 import test from 'ava';
-import getPort, {portNumbers} from './index.js';
+import getPort, {portNumbers, lockedPorts} from './index.js';
 
 test('port can be bound when promise resolves', async t => {
 	const port = await getPort();
@@ -193,3 +193,19 @@ test('preferred ports is bound up with different hosts', async t => {
 
 	t.is(port, desiredPorts[3]);
 });
+
+test('clear locked ports by lockedPorts', async t => {
+	const desiredPort = 8088;
+	const port1 = await getPort({port: desiredPort});
+	t.is(port1, desiredPort);
+
+	const port2 = await getPort({port: desiredPort});
+	// getPort is locked
+	t.not(port2, desiredPort);
+
+	// clear locked ports
+	lockedPorts.young.clear();
+	lockedPorts.old.clear();
+	const port3 = await getPort({port: desiredPort});
+	t.is(port3, desiredPort);
+});