Skip to content

Add client-side CORS solutions to error documentation#43423

Open
kovan wants to merge 1 commit intomdn:mainfrom
kovan:cors-client-solutions
Open

Add client-side CORS solutions to error documentation#43423
kovan wants to merge 1 commit intomdn:mainfrom
kovan:cors-client-solutions

Conversation

@kovan
Copy link

@kovan kovan commented Mar 12, 2026

Summary

  • Add a "Client-side considerations" section to the CORS errors landing page covering three strategies: avoiding preflight via simple requests, using no-cors mode for opaque responses, and proxy servers
  • Add a "If you don't control the server" section to the CORSMissingAllowOrigin error page pointing to these client-side alternatives

Motivation

The CORS error documentation focuses entirely on server-side fixes. Developers who don't control the server have no guidance. A maintainer commented "Please feel free to change this doc in whatever way you feel appropriate."

Fixes #39378.

Test plan

  • Landing page renders with new section
  • CORSMissingAllowOrigin page renders with new section
  • All internal links resolve
  • Code example renders correctly

Add a "Client-side considerations" section to the CORS errors
landing page covering: avoiding preflight via simple requests,
using no-cors mode for opaque responses, and proxy servers.

Also add a "If you don't control the server" section to the
CORSMissingAllowOrigin error page pointing to client-side
alternatives.

Fixes mdn#39378
@kovan kovan requested a review from a team as a code owner March 12, 2026 23:37
@kovan kovan requested review from pepelsbey and removed request for a team March 12, 2026 23:37
@github-actions github-actions bot added Content:HTTP HTTP docs size/s [PR only] 6-50 LoC changed labels Mar 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:HTTP HTTP docs size/s [PR only] 6-50 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Include client solutions in the CORS error articles?

1 participant