Cloudflare Docs
Workers
Cloudflare Docs
Workers
Search icon (depiction of a magnifying glass)
GitHub icon
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✅✅
preview✅❌Removed, use dev instead.
init✅✅
generate✅❌Removed, use git clone instead.
build✅❌Removed, invoke your own build script instead.
secret✅✅
route✅❌Removed, use publish instead.
tail✅✅
kv✅✅
r2🚧✅Introduced in wrangler 1.19.8.
pages❌✅
config✅❔
login✅✅
logout✅✅
whoami✅✅
subdomain✅❔
report✅❌Removed, error reports are made interactively.

​​ Configuration

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

​​ Features

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