Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



39 Commits

Repository files navigation

Location Polyfill

A Location polyfill for Cloudflare Workers.


Import the polyfill in your application code. Make sure it's included at the top, before any other dependencies that register fetch event listeners.

import '@worker-tools/location-polyfill';

This will populate the global location field with the url field from incoming requests. In CF Workers, this will typically be your script's address.

Note that the location field will be overwritten with each request! This is because I haven't been able to find a way to access the worker's URL outside a fetch event context. Let me know if there's a better way!

To avoid sniffing the url from every request, you can provide the location via a global variable called WORKER_LOCATION. In CF Workers, add the following to your wrangler.toml to define this variable.

  WORKER_LOCATION = 'http://localhost:8787'

This module is part of the Worker Tools collection

Worker Tools are a collection of TypeScript libraries for writing web servers in Worker Runtimes such as Cloudflare Workers, Deno Deploy and Service Workers in the browser.

If you liked this module, you might also like:

  • 🧭 Worker Router --- Complete routing solution that works across CF Workers, Deno and Service Workers
  • 🔋 Worker Middleware --- A suite of standalone HTTP server-side middleware with TypeScript support
  • 📄 Worker HTML --- HTML templating and streaming response library
  • 📦 Storage Area --- Key-value store abstraction across Cloudflare KV, Deno and browsers.
  • 🆗 Response Creators --- Factory functions for responses with pre-filled status and status text
  • 🎏 Stream Response --- Use async generators to build streaming responses for SSE, etc...
  • 🥏 JSON Fetch --- Drop-in replacements for Fetch API classes with first class support for JSON.
  • 🦑 JSON Stream --- Streaming JSON parser/stingifier with first class support for web streams.

Worker Tools also includes a number of polyfills that help bridge the gap between Worker Runtimes:

Fore more visit