Skip to main content

Function: safeParsePort()

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

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

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

Parametersโ€‹

valueโ€‹

unknown

Value to convert to port number

defaultValueโ€‹

number = 80

Fallback value if conversion fails (default: 80)

Returnsโ€‹

number

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