Function matchRoute

packages/next-routing/src/resolve-routes.ts:21–72

* Attempts to match a route against the current URL and conditions

(
  route: Route,
  url: URL,
  headers: Headers
)

 * Attempts to match a route against the current URL and conditions
 */
function matchRoute(
  route: Route,
  url: URL,
  headers: Headers
): {
  matched: boolean
  destination?: string
  headers?: Record<string, string>
  regexMatches?: RegExpMatchArray
  hasCaptures?: Record<string, string>
} {
  // Check if source regex matches the pathname
  const regex = new RegExp(route.sourceRegex)
  const regexMatches = url.pathname.match(regex)

  if (!regexMatches) {
    return { matched: false }
  }

  // Check has conditions
  const hasResult = checkHasConditions(route.has, url, headers)
  if (!hasResult.matched) {
    return { matched: false }
  }

  // Check missing conditions
  const missingMatched = checkMissingConditions(route.missing, url, headers)
  if (!missingMatched) {
    return { matched: false }
  }

  // Replace placeholders in destination
  const destination = route.destination
    ? replaceDestination(route.destination, regexMatches, hasResult.captures)
    : undefined
  const resolvedHeaders = route.headers
    ? Object.fromEntries(
        Object.entries(route.headers).map(([key, value]) => [
          replaceDestination(key, regexMatches, hasResult.captures),
          replaceDestination(value, regexMatches, hasResult.captures),
        ])
      )
    : undefined

  return {
    matched: true,
    destination,
    headers: resolvedHeaders,
    regexMatches,
    hasCaptures: hasResult.captures,
  }
}

/**
 * Processes a list of routes and updates the URL if any match