Skip to main content

Function: safeParsePort()

safeParsePort(value: unknown, defaultValue: number | PortNumber): PortNumber

Defined in: shared/utils/safeConversions.ts:247

Safely converts a value to a port number (1-65535) with fallback.

Parametersโ€‹

valueโ€‹

unknown

Value to convert to port number

defaultValueโ€‹

Fallback value if conversion fails (default: 80)

number | PortNumber

Returnsโ€‹

PortNumber

Valid port number in range 1-65535, or the default value

Remarksโ€‹

Validates that the converted integer falls within the valid TCP/UDP port range. Port 0 is reserved and not allowed. Returns the default value for any value outside the valid range or that cannot be converted.

Exampleโ€‹

safeParsePort("8080"); // 8080
safeParsePort("65536"); // 80 (out of range)
safeParsePort("0"); // 80 (invalid port)
safeParsePort("invalid"); // 80