Cloudflare Docs
Workers
Edit this page on GitHub
Set theme to dark (⇧+D)

Examples

  • Deliver an HTML page from an HTML string directly inside the Worker script.

  • Return JSON directly from a Worker script, useful for building APIs and middleware.

  • Send a request to a remote server, read HTML from the response, and serve that HTML.

  • Send a GET request and read in JSON from the response. Use to fetch external data.

  • Redirect requests from one URL to another or from one set of URLs to another set.

  • Access custom Cloudflare properties and control how Cloudflare features are applied to every request.

  • Respond to the Worker request with the response from another website (example.com in this example).

  • Allow a client to request static assets while waiting for the HTML response.

  • Set up an A/B test by controlling what response is served based on cookies. This version supports passing the request through to test and control on the origin, bypassing random assignment.

  • Send two GET request to two urls and aggregates the responses into one response.

  • Example of how to add, change, or delete headers sent in a request or returned in a response.

  • Allow or deny a request based on a known pre-shared key in a header. This is not meant to replace the WebCrypto API.

  • Inspects the incoming request's TLS version and blocks if under TLSv1.2.

  • Resolve requests to your domain to a set of proxy third-party origin URLs.

  • Redirect requests to certain URLs based on a mapped object to the request's URL.

  • Cache POST requests using the Cache API.

  • Send Additional Cache Tags using Workers

  • Determine how to cache a resource by setting TTLs, custom cache keys, and cache headers in a fetch request.

  • Return a response based on the incoming request's URL, HTTP method, User Agent, IP address, ASN or device type.

  • Given the cookie name, get the value of a cookie. You can also use cookies for A/B testing.

  • Add the necessary CORS headers to a third party API response.

  • Redirect a response based on the country code in the header of a visitor.

  • Set up custom domain for Images using a Worker or serve images using a prefix path and Cloudflare registered domain.

  • Protect sensitive data to prevent data loss, and send alerts to a webhooks server in the event of a data breach.

  • Send debugging information in an errored response to a logging service.

  • Personalize website styling based on localized user time.

  • Get all geolocation data fields and display them in HTML.

  • Fetch weather data from an API using the user's geolocation data.

  • Block other websites from linking to your content. This is useful for protecting images.

  • Shows how to restrict access using the HTTP Basic schema.

  • Examine the contents of a Headers object by logging to console with a Map.

  • Create a modified request with edited properties based off of an incoming request.

  • Fetch and modify response properties which are immutable by creating a copy first.

  • Set multiple Cron Triggers on three different schedules.

  • Send a POST request with JSON data. Use to share data with external servers.

  • Serve an HTML form, then read POST requests. Use also to read JSON or POST data from an incoming request.

  • Rewrite URL links in HTML using the HTMLRewriter. This is useful for JAMstack websites.

  • Set common security headers (X-XSS-Protection, X-Frame-Options, X-Content-Type-Options, Permissions-Policy, Referrer-Policy, Strict-Transport-Security, Content-Security-Policy).

  • Set a Cron Trigger for your Worker.

  • Verify a signed request using the HMAC and SHA-256 algorithms or return a 403.

  • Use the OpenAI v4 SDK to stream responses from OpenAI.

  • Inject Turnstile implicitly into HTML elements using the HTMLRewriter runtime API.

  • Use the Cache API to store responses in Cloudflare's cache.

  • Protect against timing attacks by safely comparing values using `timingSafeEqual`.

  • Use the WebSockets API to communicate in real time with your Cloudflare Workers.