@scalar/oas-utils/dist/helpers/fetch-with-proxy-fallback.js

Open API spec and Yaml handling utilities

import { shouldUseProxy, redirectToProxy } from './redirect-to-proxy.js';

/**
 * Fetches an OpenAPI document with a proxyUrl fallback mechanism.
 *
 * If a proxy is provided and the URL requires it, it will first attempt to fetch using the proxy.
 * If the proxy fetch fails or is not used, it will fall back to a direct fetch.
 */
async function fetchWithProxyFallback(url, { proxyUrl, cache }) {
    const fetchOptions = {
        cache: cache || 'default',
    };
    const shouldTryProxy = shouldUseProxy(proxyUrl, url);
    const initialUrl = shouldTryProxy ? redirectToProxy(proxyUrl, url) : url;
    try {
        const result = await fetch(initialUrl, fetchOptions);
        if (result.ok || !shouldTryProxy) {
            return result;
        }
        // Retry without proxyUrl if the initial request failed
        return await fetch(url, fetchOptions);
    }
    catch (error) {
        if (shouldTryProxy) {
            // If proxyUrl failed, try without it
            return await fetch(url, fetchOptions);
        }
        throw error;
    }
}

export { fetchWithProxyFallback };