SandboxAskCallback typedef

SandboxAskCallback = Future<Object> Function(NetworkHostPattern params)

Asked about a host that no configured rule and no per-command allow list decided (never asked under network.strictAllowlist). Only true allows. { allow: false, reason } denies with that reason, which the violation line reports, and which the sandboxed client reads as the status phrase of the 403 that answers its CONNECT. false and every other answer, truthy or not, deny with the generic reason "user denied": a reason on an object that does not say allow: false is not reported.

The reason is sanitized like the rest of a violation line (runs of control or invisible characters become one space, < and > are removed, the ends are trimmed) and cut to 500 UTF-16 code units, so write it as one line of plain text. With nothing left, "user denied" is reported.

Check SandboxManager.askCallbackDenyReason before returning an object: a release without it reads any truthy answer as an allow.

Implementation

typedef SandboxAskCallback = Future<Object> Function(NetworkHostPattern params);