Interface PassThroughInitialTransforms

This defines the request transforms that we support for all passed through requests (both HTTP and WebSockets).

interface PassThroughInitialTransforms {
    matchReplaceHost?: {
        replacements: MatchReplacePairs;
        updateHostHeader?: string | boolean;
    };
    matchReplacePath?: MatchReplacePairs;
    matchReplaceQuery?: MatchReplacePairs;
    replaceHost?: {
        targetHost: string;
        updateHostHeader?: string | boolean;
    };
}

Hierarchy (view full)

Properties

matchReplaceHost? matchReplacePath? matchReplaceQuery? replaceHost?

Properties

OptionalmatchReplaceHost

matchReplaceHost?: {
    replacements: MatchReplacePairs;
    updateHostHeader?: string | boolean;
}

Perform a series of string match & replace operations on the request host.

This cannot be combined with replaceHost.

If updateHostHeader is true, the Host (or :authority for HTTP/2+) header will be updated automatically to match. If updateHostHeader is a string, that will be used directly as the header value. If it's false no change will be made. If not specified this defaults to true.

OptionalmatchReplacePath

matchReplacePath?: MatchReplacePairs

Perform a series of string match & replace operations on the request path.

OptionalmatchReplaceQuery

matchReplaceQuery?: MatchReplacePairs

Perform a series of string match & replace operations on the request query string.

OptionalreplaceHost

replaceHost?: {
    targetHost: string;
    updateHostHeader?: string | boolean;
}

Replace the request host with a single fixed value, effectively forwarding all requests to a different hostname.

This cannot be combined with matchReplaceHost.

If updateHostHeader is true, the Host (or :authority for HTTP/2+) header will be updated automatically to match. If updateHostHeader is a string, that will be used directly as the header value. If it's false no change will be made. If not specified this defaults to true.

Settings

Member Visibility

On This Page

Properties