Document usage of agent

[char0n]

More information in this comment. Let's document the fact that our http interface consumes another options from fetch interface in more generic way and add a concrete example about using agent as described in attached comment.

[charlescoult-boeing]

Was this ever resolved? I'm trying to use a custom https agent that supplies a cert and the only way I've been able to get it working is through a requestInterceptor that uses Axios:

            requestInterceptor: (request) => {
                // console.log('adding agent')
                request.agent = httpsAgent
                // request.httpsAgent = httpsAgent
                // request.data = body
                request.userFetch = async (url, req) => {
                    // console.log(`fetching`)
                    // return fetch(url, { ...req, agent: agent })

                    const axiosRequest = { ...req, data: req.body, httpsAgent: request.agent }
                    const axiosResponse = await axios(axiosRequest)
                    debugger

                    /* not ideal but axios already parses the JSON response data
                     * and SwaggerClient expects it to still be in text form so
                     * we need to stringify it again */
                    return new Response(JSON.stringify(axiosResponse.data), {
                        status: axiosResponse.status,
                        headers: axiosResponse.headers,
                    })
                }
                return request
            },