net.port-list

Imports name this capability’s declared dependencies, which fune builds next to it in your project; each one links to its page.

import { isPort } from "./net_port.ts";  ← from net.port ^1.0.0 · built alongside by fune

/** Spaces and tabs only: a newline inside a port list is a mistake, not padding. */
function trimBlank(s: string): string {
  return s.replace(/^[ \t]+/, "").replace(/[ \t]+$/, "");
}

/** Whole ASCII digits with no leading zero: "80", not "080", "+80" or "٨٠". */
function isNumber(s: string): boolean {
  return /^[0-9]+$/.test(s) && (s.length === 1 || s[0] !== "0");
}

function port(token: string): number {
  // More than five digits cannot be a port, and would overflow elsewhere.
  const value = token.length > 5 ? 0 : Number(token);
  if (!isPort(value)) throw new RangeError(`port "${token}" is out of range 1-65535`);
  return value;
}

/**
 * Parse a port list such as "22,80,8000-8010" into port numbers: each port
 * once, in the order first given. Ranges are inclusive.
 */
export function parsePortList(text: string): readonly number[] {
  if (typeof text !== "string") throw new TypeError("text must be a string");
  if (trimBlank(text) === "") throw new RangeError("port list is empty");
  const out: number[] = [];
  const seen = new Set<number>();
  const add = (p: number) => {
    if (!seen.has(p)) {
      seen.add(p);
      out.push(p);
    }
  };
  for (const raw of text.split(",")) {
    const item = trimBlank(raw);
    if (item === "") throw new RangeError("empty item in port list");
    if (item.includes("-")) {
      const ends = item.split("-");
      if (ends.length !== 2 || !isNumber(ends[0]) || !isNumber(ends[1])) {
        throw new RangeError(`invalid port range "${item}"`);
      }
      const low = port(ends[0]);
      const high = port(ends[1]);
      if (low > high) throw new RangeError(`port range "${item}" runs backwards`);
      for (let p = low; p <= high; p++) add(p);
    } else {
      if (!isNumber(item)) throw new RangeError(`invalid port "${item}"`);
      add(port(item));
    }
  }
  return out;
}