docs: add proxy configuration for Bun and Deno

[Copilot]

ofetch works on Node.js, Bun, and Deno, but only Node.js proxy configuration was documented. This PR adds concise proxy documentation for all three runtimes.

Changes

README.md

• Added important callout at the top about environment variable support:
  • Bun and Deno respect HTTP_PROXY and HTTPS_PROXY environment variables
  • Node.js requires NODE_USE_ENV_PROXY=1 to enable built-in proxy support
• Reorganized "Adding HTTP(S) Agent" → "Proxy Support" with compact, runtime-specific subsections
• Node.js: Streamlined documentation for undici ProxyAgent with dispatcher option (basic proxy, global proxy, self-signed certs)
• Bun and Deno: Combined subsection documenting:
  • Bun's native proxy option: proxy: "http://localhost:3128"
  • Deno's undici npm specifier option for programmatic configuration

examples/proxy.mjs

• Unified example showing all three proxy configuration approaches in one file (~18 lines)
• Single ofetch call with all three proxy options shown with clear comments
• All options commented out by default - users uncomment the relevant import and option for their runtime

Example

The unified example in examples/proxy.mjs:

import { ofetch } from "ofetch";

// Node.js: Use undici ProxyAgent with dispatcher option
// import { ProxyAgent } from "undici";
// const proxyAgent = new ProxyAgent("http://localhost:3128");

// Bun: Use native proxy option
// const proxy = "http://localhost:3128";

// Deno: Set HTTP_PROXY environment variable or use undici with npm specifier
// HTTP_PROXY=http://localhost:3128 deno run --allow-net proxy.mjs

const data = await ofetch("https://icanhazip.com", {
  // dispatcher: proxyAgent, // Node.js
  // proxy, // Bun
});

console.log(data);

The documentation is compact (~45 lines in README vs original ~130 lines) and the example is unified (~18 lines vs original ~65 lines) while maintaining all essential information.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Bun proxy support</issue_title>
<issue_description>### Describe the feature

Currently, ofetch proxy support use the node undici features.
Bun has a different way to use proxy (through the proxy option) instead of agents.

I may be able to implement this later as I guess it's not a urgent issue.

Additional information

• Would you be willing to help implement this feature?</issue_description>

<agent_instructions>research in Bun and Deno docs how to programatically set proxy per fetch. Add short readme docs about proxy for Node, Deno and Bun updating old section</agent_instructions>

Comments on the Issue (you are @copilot in this section)

@pi0 Hi. Types might be missing but you can pass any config to fetch options, incliding bun specific proxy config. @pi0 We should def add a note in docs about using proxy with Deno and Bun, PR welcome!

• Fixes Bun proxy support #538

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[pi0]

@copilot

• update title to be semantic
• move bun and deno below node section also make docs more compact, simple

[Copilot]

@copilot

• update title to be semantic
  ...

Made the documentation more compact and simple in f39d26d. The section now has:

• Node.js first with 3 focused examples (basic proxy, global proxy, self-signed certs)
• Bun and Deno combined in one subsection below
• Removed verbose explanations and duplicate examples
• Reduced from ~130 lines to ~40 lines while keeping all essential information

Regarding the semantic title - I can't update the PR title directly, but suggest: "docs: add proxy configuration for Bun and Deno"

[pi0]

@copilot Move this note to first of proxy support section as an > [IMPORTANT] bot and mention Node.js needs NODE_USE_ENV_PROXY-1 for global env var (https://nodejs.org/api/http.html#http_built_in_proxy_support)

[Copilot]

Added the important callout about environment variables at the top of the proxy support section in 94bc5c6. The note now mentions that Node.js requires NODE_USE_ENV_PROXY=1 to enable built-in proxy support, with a link to the Node.js documentation.

[Copilot]

Just as a heads up, I was blocked by some firewall rules while working on your feedback. Expand below for details.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• icanhazip.com
  • Triggering command: /usr/local/bin/node node examples/proxy.mjs (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)