cloudflare · Cloudflare Workers Docs
Workers Known issues
Identifies specific platform limitations and provides workarounds for route specificity behavior, wrangler dev preview token restrictions, CNAME setup DNS requirements, and IP address fetching limitations.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Workers Known issues
Identifies specific platform limitations and provides workarounds for route specificity behavior, wrangler dev preview token restrictions, CNAME setup DNS requirements, and IP address fetching limitations.
When To Use
Use when troubleshooting unexpected route matching, resolving 530 errors in CNAME setups, bypassing wrangler dev preview token restrictions, or attempting to fetch resources via IP addresses in Workers.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/workers-known-issues-workflow-guide.md | A list of documented bugs and platform limitations for Cloudflare Workers including route specificity and Fetch API behaviors. | Questions about a list of documented bugs and platform limitations for Cloudflare Workers including route specificity and Fetch API b... |
examples/workers-known-issues-cloudflare-workers-known-issues-pattern-matching-ex.text | Textual examples demonstrating how pattern matching behaves with specific URL path structures in Cloudflare Workers. | Exact payloads, commands, or snippets shown in Textual examples demonstrating how pattern matching behaves with specific URL path structures in Cloudflare Workers. |
examples/workers-known-issues-cloudflare-workers-known-issues-url-parsing-example.text | Textual examples demonstrating specific URL parsing behaviors and edge cases identified as known issues in Cloudflare Workers. | Exact payloads, commands, or snippets shown in Textual examples demonstrating specific URL parsing behaviors and edge cases identified as known issues in Cloudflare... |
examples/workers-known-issues-cloudflare-workers-known-issues-request-header-dele.text | A code snippet demonstrating how to delete the cf-workers-preview-token header from a request object to resolve specific known issues. | Exact payloads, commands, or snippets shown in A code snippet demonstrating how to delete the cf-workers-preview-token header from a request object to resolve speci... |
examples/workers-known-issues-cloudflare-workers-dns-partial-setup-fetch-resoluti.text | A text representation of a DNS partial setup scenario where certain subdomains fail to resolve via the Fetch API, resulting in a 530 status code. | Exact payloads, commands, or snippets shown in A text representation of a DNS partial setup scenario where certain subdomains fail to resolve via the Fetch API, res... |
examples/workers-known-issues-cloudflare-workers-partial-dns-setup-resolution-iss.text | A text representation of how the Fetch API resolves DNS records when a zone is in a partial setup state. | Exact payloads, commands, or snippets shown in A text representation of how the Fetch API resolves DNS records when a zone is in a partial setup state. |
examples/workers-known-issues-cloudflare-workers-known-issues-fetch.text | A text representation of a code snippet demonstrating a known issue when using the fetch API in Cloudflare Workers. | Exact payloads, commands, or snippets shown in A text representation of a code snippet demonstrating a known issue when using the fetch API in Cloudflare Workers. |
examples/workers-known-issues-cloudflare-workers-known-issues-fetch-ip-limit.text | A text example demonstrating the known issue when attempting to fetch a private IP address within a Cloudflare Worker. | Exact payloads, commands, or snippets shown in A text example demonstrating the known issue when attempting to fetch a private IP address within a Cloudflare Worker. |
What This Skill Covers
- Below are some known bugs and issues to be aware of when using Cloudflare Workers.
- Main sections:
Route specificity,wrangler dev,Fetch API in CNAME setup,Fetch to IP addresses.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://developers.cloudflare.com/workers/platform/known-issues