Cloudflare Docs
Workers
Visit Workers on GitHub
Set theme to dark (⇧+D)

New in Wrangler 2

wrangler 2 introduces a number of new features for developing and deploying a Worker. This document is to show previous users of wrangler 1 what they can expect when they move to wrangler 2.

  • wrangler.toml is no longer mandatory.
  • dev and publish accept CLI arguments.
  • tail can be run on arbitrary Worker names
  • init creates a project boilerplate.
  • Service environments.
  • JSON bindings for vars.
  • Local mode for wrangler dev.
  • Module system (for both modules and service worker format Workers).
  • Devtools.
  • Typescript support.
  • Sharing development environment on the Internet.
  • Wider platform compatibility.
  • Developer hotkeys.
  • Better configuration validation.

Wrangler 1 and 2 comparison table

Commands

Command12Notes
publish
dev
previewRemoved, use dev instead.
init
generateRemoved, use git clone instead.
buildRemoved, invoke your own build script instead.
secret
routeRemoved, use publish instead.
tail
kv
r2🚧Introduced in wrangler 1.19.8.
pages
config
login
logout
whoami
subdomain
reportRemoved, error reports are made interactively.

Configuration

Property12Notes
type = "webpack"Removed, look at this guide to migrate.
type = "rust"Removed, use workers-rs instead.
type = "javascript"🚧No longer required, can be omitted.

Features

Feature12Notes
TypeScriptYou can give wrangler a TypeScript file, and it will automatically transpile it to JavaScript using esbuild under-the-hood.
Local modewrangler dev --local will run your Worker on your local machine instead of on our network. This is powered by Miniflare.