Make Compat Matrix more comprehensive #17303
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -17,29 +17,42 @@ import { | |||||
| Tabs, | ||||||
| } from "~/components"; | ||||||
|
|
||||||
| You can deply full-stack applications, including front-end static assets and back-end APIs and server-side rendered pages (SSR), to both Cloudflare [Workers](/workers/static-assets/) and [Pages](/pages/). The compatibility matrix below shows which features are available for each, to help you choose whether to build with Workers or Pages. Unless otherwise stated below, what works in Pages works in Workers, and what works in Workers works in Pages. Think something is missing from this list? [Open a pull request](https://github.com/cloudflare/cloudflare-docs/edit/production/src/content/docs/workers/static-assets/compatibility-matrix.mdx) or [create a GitHub issue](https://github.com/cloudflare/cloudflare-docs/issues/new). | ||||||
|
|
||||||
| We plan to bridge the gaps between Workers and Pages and provide ways to migrate your Pages projects to Workers. | ||||||
|
|
||||||
|
|
||||||
| | | Workers | Pages | | ||||||
| | ----------------------------------------------------------------------------------- | ------------------------ | ----- | | ||||||
| | **Writing, Testing, and Deploying Code** | | | | ||||||
| | [Rollbacks](/workers/configuration/versions-and-deployments/rollbacks/) | ✅ | ✅ | | ||||||
| | [Gradual Deployments](/workers/configuration/versions-and-deployments/) | ✅ | ❌ | | ||||||
| | [Preview URLs](/workers/configuration/previews) | ✅ | ✅ | | ||||||
| | [Testing tools](/workers/testing) | ✅ | ✅ | | ||||||
| | [Local Development](/workers/testing/local-development/) | ✅ | ✅ | | ||||||
| | [Remote Development (`--remote`)](/workers/wrangler/commands/) | ✅ <sup>1</sup> | ❌ | | ||||||
GregBrimble marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
| | [Quick Editor in Dashboard](https://blog.cloudflare.com/improved-quick-edit) | ✅ | ❌ | | ||||||
| | **Static Assets** | | | | ||||||
| | [Early Hints](/pages/configuration/early-hints/) | ❌ | ✅ | | ||||||
| | [Custom HTTP headers for static assets](/pages/configuration/headers/) | 🟡 <sup>2</sup> | ✅ | | ||||||
| | [Middleware](/pages/functions/middleware/) | 🟡 <sup>3</sup> | ✅ | | ||||||
| | [Redirects](/pages/configuration/redirects/) | 🟡 <sup>4</sup> | ✅ | | ||||||
| | [Smart Placement](/workers/configuration/smart-placement/) | ⏳ <sup>5</sup> | ✅ | | ||||||
| | **Observability** | | | | ||||||
| | [Workers Logs](/workers/observability/) | ✅ | ❌ | | ||||||
| | [Logpush](/workers/observability/logs/logpush/) | ✅ | ❌ | | ||||||
| | [Tail Workers](/workers/observability/logs/tail-workers/) | ⏳ <sup>6</sup> | ❌ | | ||||||
| | [Real-time logs](/workers/observability/logs/real-time-logs/) | ✅ | ✅ | | ||||||
| | **Runtime APIs & Compute Models** | | | | ||||||
| | [Node.js Compatibility Mode](/workers/runtime-apis/nodejs/) | ✅ | ✅ | | ||||||
| | [Durable Objects](/durable-objects/api/) | ✅ | 🟡 <sup>7</sup> | | ||||||
|
Contributor
There was a problem hiding this comment. Why is DO here? Would expect this to be under bindings
Contributor
Author
There was a problem hiding this comment. A DO is a singleton Worker, as fundamental a compute primitive to the platform as a Worker. We need to stop treating it just as binding but as first-class compute primitive. Can move back to bindings for now from here but it is apples vs. oranges to other bindings. @vy-ton re: framing, I think we have habit of bucketing DO with other bindings but feels different
Contributor
There was a problem hiding this comment. +1 grouping DO under Runtime APIs, DO team has #17411 (comment) to create |
||||||
| | [Cron Triggers](/workers/configuration/cron-triggers/) | ✅ | ❌ | | ||||||
| | **Bindings** | | | | ||||||
| | [AI](/workers-ai/get-started/workers-wrangler/#2-connect-your-worker-to-workers-ai) | ✅ | ✅ | | ||||||
| | [Analytics Engine](/analytics/analytics-engine) | ✅ | ✅ | | ||||||
| | [Assets](/workers/static-assets/binding/) | ✅ | ❌ | | ||||||
GregBrimble marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
| | [Browser Rendering](/browser-rendering) | ✅ | ✅ | | ||||||
| | [D1](/d1/build-with-d1/d1-client-api/) | ✅ | ✅ | | ||||||
| | [Environment Variables](/workers/configuration/environment-variables/) | ✅ | ✅ | | ||||||
| | [Hyperdrive](/hyperdrive/) | ✅ | ❌ | | ||||||
| | [KV](/kv/) | ✅ | ✅ | | ||||||
|
|
@@ -51,22 +64,46 @@ We plan to bridge the gaps between Workers and Pages and provide ways to migrate | |||||
| | [Secrets](/workers/configuration/secrets/) | ✅ | ✅ | | ||||||
| | [Service bindings](/workers/runtime-apis/bindings/service-bindings/) | ✅ | ✅ | | ||||||
| | [Vectorize](/vectorize/get-started/intro/#3-bind-your-worker-to-your-index) | ✅ | ✅ | | ||||||
| | **Builds (CI/CD)** | | | | ||||||
| | [Monorepos](/workers/ci-cd/builds/advanced-setups/) | ✅ | ✅ | | ||||||
| | [Build Watch Paths](/pages/configuration/build-watch-paths/) | ❌ | ✅ | | ||||||
|
|
||||||
| | [Deploy Hooks](/pages/configuration/deploy-hooks/) | ❌ | ✅ | | ||||||
| | [Build Caching](/pages/configuration/build-caching/) | ❌ | ✅ | | ||||||
| | [Custom Preview Branches](/pages/configuration/branch-build-controls/) | ❌ | ✅ | | ||||||
| | [Custom Branch Aliases](/pages/how-to/custom-branch-aliases/) | ❌ | ✅ | | ||||||
| | **Pages Functions** | | | | ||||||
| | [File-based Routing](/pages/functions/routing/) | ❌ <sup>8</sup> | ✅ | | ||||||
| | [Pages Plugins](/pages/functions/plugins/) | ❌ <sup>9</sup> | ✅ | | ||||||
|
|
||||||
|
|
||||||
| <sup>1</sup> For more details on which bindings are supported in remote development, [refer to the docs](/workers/testing/local-development/#supported-resource-bindings-in-different-environments) | ||||||
irvinebroque marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
|
||||||
| <sup>2</sup> Similar to <sup>1</sup>, to customize the HTTP headers that | ||||||
|
Contributor
There was a problem hiding this comment.
Suggested change
|
||||||
| are returned by static assets, you can use [Service | ||||||
| bindings](/workers/runtime-apis/bindings/service-bindings/) to connect a Worker | ||||||
| in front of the Worker with assets. | ||||||
|
|
||||||
| <sup>3</sup> If you need to run a Worker before serving static assets, | ||||||
| you can create a separate Worker that acts as middleware, and then use [Service | ||||||
| bindings](/workers/runtime-apis/bindings/service-bindings/) to forward the request | ||||||
| to the Worker with assets. We plan to explore additional configuration | ||||||
| to support more complex routing in the future. | ||||||
|
|
||||||
| <sup>4</sup> You can handle redirects by adding code to your Worker (a | ||||||
| [community package](https://npmjs.com/package/redirects-in-workers) is available | ||||||
| for `_redirects` support), or you can use [Bulk | ||||||
| Redirects](/rules/url-forwarding/bulk-redirects/). | ||||||
|
|
||||||
| <sup>5</sup> You cannot yet enable [Smart | ||||||
| Placement](/workers/configuration/smart-placement/) for Workers with static assets. | ||||||
| This is a temporary limitation, we are working to remove it. | ||||||
irvinebroque marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
|
||||||
| <sup>6</sup> You cannot yet add a [Tail | ||||||
| Worker](/workers/observability/logs/tail-workers/) to a project with assets. | ||||||
| This is a temporary limitation, we are working to remove it. | ||||||
irvinebroque marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
|
||||||
| <sup>7</sup> To [use Durable Objects with your Cloudflare Pages project](/pages/functions/bindings/#durable-objects), you must create a separate Worker with a Durable Object, and then declare a binding to it in both your Production and Preview environments. Using Durable Objects with Workers is simpler, and recommended. | ||||||
irvinebroque marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
|
||||||
| <sup>8</sup> Workers [supports popular frameworks](/workers/frameworks/), many of which implement file-based routing. | ||||||
|
|
||||||
| <sup>9</sup> Everything that is possible with Pages Functions, can also be achieved by adding code to your Worker, or using framework-specific plugins for relevant third party tools. | ||||||
irvinebroque marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.