[voyagi]

Summary

The "Advanced routing control" section of the Single Page Application page recommends run_worker_first with an array. In that setup, a request with a method other than GET or HEAD to a path that matches none of the patterns never reaches the Worker script: asset serving answers it with 405 Method Not Allowed.

The section says the array turns off the Sec-Fetch-Mode: navigate detection, but not that unlisted non-GET requests then stop at asset serving. The routing diagram further down reads as if a non-navigation request that matches no file falls through to the Worker script, which is not the case with an array in SPA mode, and no page mentions the 405. This PR adds one note under the example.

Why it happens, in workers-sdk at 08f22d3:

• A request that matches no static routing rule goes to unstable_canFetch before the Worker script is considered (router-worker worker.ts L282-L345).
• With static routing, canFetch keeps not_found_handling, so in SPA mode every path has an asset intent and canFetch returns true (asset-worker handler.ts L284-L322).
• Asset serving returns MethodNotAllowedResponse for any method other than GET and HEAD (asset-worker handler.ts L111-L122).

Seen on a deployed Worker with this configuration:

"assets": {
	"binding": "ASSETS",
	"not_found_handling": "single-page-application",
	"run_worker_first": ["/mcp", "/mcp/*", "/api/*"]
}

Request	Response
GET /no-such-page	200, the index.html shell
POST /no-such-page	405 Method Not Allowed, empty body
PUT /no-such-page	405 Method Not Allowed, empty body
POST /mcp (listed)	the Worker script's own response

Documentation checklist

• The change adheres to the documentation style guide.

[cloudflare-docs-bot]

Review coverage

🟡 1 ownership area needs approval.

Suggested reviewers: @dinasaur404 @for-the-kidz @WalshyDev

Needs approval	Eligible approvers	Suggested
workers	@GregBrimble, @irvinebroque, @MattieTK, @vy-ton, @WalshyDev, @cloudflare/deploy-config, @cloudflare/product-owners	dinasaur404, for-the-kidz, WalshyDev

CODEOWNERS mappings for displayed areas (1)

Pattern	Owners
/src/content/docs/workers/static-assets	@GregBrimble, @irvinebroque, @MattieTK, @vy-ton, @WalshyDev, @cloudflare/deploy-config, @cloudflare/product-owners

[cloudflare-docs-bot]

AI Review

✅ Reviewed 80b45ef · 0 findings · incremental

Commands

• /review Run a review now.
• /full-review Review the entire PR diff.
• /disable-auto-review Stop automatic reviews.
• /rebase Rebase against production.