Skip to main content

Function: openExternalOrThrow()

function openExternalOrThrow(args: {
failureMessagePrefix: string;
normalizedUrl: string;
safeUrlForLogging: string;
}): Promise<void>;

Defined in: electron/services/shell/openExternalUtils.ts:25

Opens a validated external URL via shell.openExternal.

Parameters

args

failureMessagePrefix

string

Prefix used in the thrown error message.

normalizedUrl

string

A URL already validated and normalized (e.g., from urlSafety helpers).

safeUrlForLogging

string

A safe representation to include in errors/logs (redacted).

Returns

Promise<void>

Remarks

This helper centralizes error formatting so that failures never echo the full URL (which may contain secrets). Callers must pass a pre-redacted safeUrlForLogging.