Function canUseOrCacheRequest

packages/common/http/src/transfer_cache.ts:147–178

(req: HttpRequest<unknown>, options: CacheOptions)

const ALLOWED_METHODS = ['GET', 'HEAD'];

function canUseOrCacheRequest(req: HttpRequest<unknown>, options: CacheOptions): boolean {
  const {
    isCacheActive,
    filter,
    includePostRequests,
    includeRequestsWithAuthHeaders,
    includeRequestsWithCredentials,
    includeNonCacheableRequests,
  } = options;
  const {transferCache: requestOptions, method: requestMethod} = req;

  if (
    !isCacheActive ||
    requestOptions === false ||
    // POST requests are allowed either globally or at request level
    (requestMethod === 'POST' && !includePostRequests && !requestOptions) ||
    (requestMethod !== 'POST' && !ALLOWED_METHODS.includes(requestMethod)) ||
    // Do not cache requests with authentication or cookie headers unless explicitly enabled.
    (!includeRequestsWithAuthHeaders && hasAuthHeaders(req)) ||
    // Do not cache requests sent with credentials unless explicitly enabled.
    (!includeRequestsWithCredentials && hasOutgoingCredentials(req)) ||
    // Do not cache requests that explicitly forbid caching via Cache-Control
    // or Fetch API cache mode unless explicitly enabled.
    (!includeNonCacheableRequests &&
      (hasUncacheableCacheControl(req.headers) || isNonCacheableRequest(req.cache))) ||
    filter?.(req) === false
  ) {
    return false;
  }

  return true;
}

function getHeadersToInclude(
  options: CacheOptions,