Struct ControlRequest 

pub struct ControlRequest {
    pub url: String,
    pub method: String,
    pub headers: BTreeMap<String, String>,
    pub body: Option<String>,
    pub stream: bool,
    pub target: Option<String>,
    pub allow_origin: Option<String>,
    pub credentials: Option<String>,
    pub encoding: Option<String>,
}

A request as supplied by a control-plane caller (the POST /__bridge/request body, or synthesised from the path/method/headers of a transparent-proxy request).

url is resolved against the page origin by the browser snippet; absolute URLs are rejected by the server unless an --allow-origin permits them.

Fields

url: String

Request URL. Relative (page-origin) by default.

method: String

HTTP method. Defaults to GET when omitted.

headers: BTreeMap<String, String>

Request headers. Forwarded verbatim to the browser fetch().

body: Option<String>

Request body, or null for no body.

stream: bool

When true, the response is streamed back as incremental chunk frames (response.body.getReader()) rather than buffered into one reply.

target: Option<String>

Which connected tab to route this request to: a connection id (the canonical, always-unambiguous selector) or an Origin string that uniquely matches one tab. Omitted is allowed only when exactly one tab is connected. The X-Omni-Bridge-Target header takes precedence over this field. Server-side routing only — never sent to the browser.

allow_origin: Option<String>

Request-scoped outbound-origin override. When present it takes precedence over the per-origin serve --allow-origin grant for this request’s crate::browser::auth::validate_outbound_url check only, letting one request target a cross-origin URL without affecting the connection-time WS-upgrade gate. Server-side scope check only — never sent to the browser.

credentials: Option<String>

Fetch credentials mode (include | omit | same-origin). Absent means the browser snippet defaults to include, preserving v1 behavior.

encoding: Option<String>

Request-body transfer encoding. Some("base64") means body is a base64 string the browser snippet decodes to a byte array before fetch(); absent (the default) means body is UTF-8 text, preserving v1 wire-compat. Mirrors the response-side encoding on BrowserReply.

Trait Implementations

impl Clone for ControlRequest

fn clone(&self) -> ControlRequest

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ControlRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ControlRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ControlRequest

impl PartialEq for ControlRequest

fn eq(&self, other: &ControlRequest) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ControlRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ControlRequest