Cloudflare Workers Toolkit

This library provides a simple integration to Cloudflare's APIs for resources applicable to Cloudflare Workers.

$3

There are some subtle and not so subtle differences between Cloudflare accounts with multiscript enabled or not. By default, a standard Cloudflare account has single script enabled and an enterprise account has multi script enabled.

The subtle difference has to do with whether you deploy scripts by account or zone. The worker scripts take either an accountId (multi script) or zoneId (single script). When using an accountId, you must also specify a name for the script. You do not need to name a single script (zoneId) worker.

The not so subtle difference is that single script accounts use filters and multi script accounts use routes. Routes and Filters both use a URL pattern to control worker behavior. The difference is that filters control whether the single worker runs or doesn't run, whereas routes control which worker script is run.

$3

``
npm install cloudflare-workers-toolkit
`

$3

`
const cloudflare = require("cloudflare-workers-toolkit");
cloudflare.setAccountId(accountId); // helper that sets an ENV var
cloudflare.setZoneId(zoneId);
`

$3

Deploy a worker (will overwrite as well as create)

`
cloudflare.workers.deploy({
accountId,
name: "My Worker",
script: "addEventListener('fetch', event => {
event.respondWith(new Response(event.request));
});",
bindings: []
})
`

`
cloudflare.workers.getSettings()
`

$3

Get all routes for a zone
`
cloudflare.routes.getRoutes({zoneId})
`

Remove a route
`
cloudflare.routes.remove({zoneId, routeId})
`

$3

`
cloudflare.storage.getNamespaces({accountId})
cloudflare.storage.createNamespace({accountId, name: "namespace name"})
cloudflare.storage.removeNamespace({accountId, namespaceId})
`

You can also pass name to remove. This method will look the id up for you before requesting the removal.

`
cloudflare.storage.removeNamespace({accountId, name: "my namespace name"})
`

$3

Cloudflare worker toolkit requires the following environment variables to be set:

`
CLOUDFLARE_AUTH_EMAIL
CLOUDFLARE_AUTH_KEY
`

Methods optionally take needed additional parameters, such as accountId. However, the following environment variables will be used as a fallback if set.

`
CLOUDFLARE_ACCOUNT_ID
``