Function portForwardURL

site/src/utils/portForward.ts:25–55

(
	host: string,
	port: number,
	agentName: string,
	workspaceName: string,
	username: string,
	protocol: WorkspaceAgentPortShareProtocol,
	pathname?: string,
	search?: string,
)

};

export const portForwardURL = (
	host: string,
	port: number,
	agentName: string,
	workspaceName: string,
	username: string,
	protocol: WorkspaceAgentPortShareProtocol,
	pathname?: string,
	search?: string,
): string => {
	const { location } = window;
	const suffix = protocol === "https" ? "s" : "";

	const subdomain = `${port}${suffix}--${agentName}--${workspaceName}--${username}`;

	const baseUrl = `${location.protocol}//${host.replace(/\*/g, subdomain)}`;
	try {
		const url = new URL(baseUrl);
		if (pathname) {
			url.pathname = pathname;
		}
		if (search) {
			url.search = search;
		}
		return url.toString();
	} catch {
		// When the proxy host is empty or invalid, return a do-nothing anchor
		// so the link renders without navigating anywhere.
		return "#";
	}
};

/**
 * Rewrite a localhost URL to use the workspace port-forward subdomain.