OptionalmethodOptionalheadersOptionalbodyOptionalallowAllow http:// and private/loopback targets. Default false.
OptionaltimeoutOverall timeout including DNS + connect + body read. Default 10_000 ms.
OptionalmaxHard cap on response body bytes. Default 64 KiB.
OptionalsignalCaller-provided abort signal, composed with the internal timeout.
OptionallookupDNS resolver override for dependency injection. Every returned address is
still classified by the SSRF policy, and the selected address is still
pinned into the undici dispatcher. Defaults to dns/promises.lookup.
OptionaltlsDeclarative client-authentication material for a runner-owned HTTPS connection. Certificate verification remains enabled and SNI is always derived from the validated URL hostname; callers cannot override either.
OptionaltrustedTrusted scoped fetch implementation. URL scheme validation, redirect handling, timeouts, and body limits still run, but DNS resolution and address policy are delegated to this implementation because custom fetchers do not accept undici dispatchers. The caller MUST enforce DNS-rebinding and private-address policy itself.
This deliberately explicit name prevents callers from mistaking a custom transport for the internally DNS-pinned path.
Optionalinit: RequestInitOptionalinit: RequestInit
Lowercased keys preferred; values preserved verbatim.