changelog entry

Author: celso

src/content/changelog/email-routing/2025-04-04-local-development.mdx

@@ -0,0 +1,77 @@
+---
+title: Local development support for Email Workers
+description: Developers can now use wrangler to do local development for Email Workers.
+date: 2025-04-04T17:00:00Z
+---
+
+Developers can now test the behavior of an Email Worker script, receiving, replying and sending emails in your local environment using `wrangler dev`.
+
+In this example we receive messages using the `email()` handler and parse them using [postal-mime](https://www.npmjs.com/package/postal-mime):
+
+```ts
+import * as PostalMime from 'postal-mime';
+
+export default {
+	async email(message, env, ctx) {
+		const parser = new PostalMime.default();
+		const rawEmail = new Response(message.raw);
+		const email = await parser.parse(await rawEmail.arrayBuffer());
+		console.log(email);
+	},
+};
+
+Now when you run `npx wrangler dev`, wrangler will expose a local `/cdn-cgi/handler/email` endpoint that you can `POST` email messages to and trigger your Worker's `email()` handler:
+
+```bash
+curl -X POST 'http://localhost:8787/cdn-cgi/handler/email' \
+  --url-query '[email protected]' \
+  --url-query '[email protected]' \
+  --header 'Content-Type: application/json' \
+  --data-raw 'Received: from smtp.example.com (127.0.0.1)
+        by cloudflare-email.com (unknown) id 4fwwffRXOpyR
+        for <[email protected]>; Tue, 27 Aug 2024 15:50:20 +0000
+From: "John" <[email protected]>
+Reply-To: [email protected]
+To: [email protected]
+Subject: Testing Email Workers Local Dev
+Content-Type: text/html; charset="windows-1252"
+X-Mailer: Curl
+Date: Tue, 27 Aug 2024 08:49:44 -0700
+Message-ID: <6114391943504294873000@ZSH-GHOSTTY>
+
+Hi there'
+```
+
+This is what you get in the console:
+
+```json
+{
+  headers: [
+    {
+      key: 'received',
+      value: 'from smtp.example.com (127.0.0.1) by cloudflare-email.com (unknown) id 4fwwffRXOpyR for <[email protected]>; Tue, 27 Aug 2024 15:50:20 +0000'
+    },
+    { key: 'from', value: '"John" <[email protected]>' },
+    { key: 'reply-to', value: '[email protected]' },
+    { key: 'to', value: '[email protected]' },
+    { key: 'subject', value: 'Testing Email Workers Local Dev' },
+    { key: 'content-type', value: 'text/html; charset="windows-1252"' },
+    { key: 'x-mailer', value: 'Curl' },
+    { key: 'date', value: 'Tue, 27 Aug 2024 08:49:44 -0700' },
+    {
+      key: 'message-id',
+      value: '<6114391943504294873000@ZSH-GHOSTTY>'
+    }
+  ],
+  from: { address: '[email protected]', name: 'John' },
+  to: [ { address: '[email protected]', name: '' } ],
+  replyTo: [ { address: '[email protected]', name: '' } ],
+  subject: 'Testing Email Workers Local Dev',
+  messageId: '<6114391943504294873000@ZSH-GHOSTTY>',
+  date: '2024-08-27T15:49:44.000Z',
+  html: 'Hi there\n',
+  attachments: []
+}
+```
+
+Local development also works for sending, replying and forwarding emails. See [our documentation](/email-routing/email-workers/local-development/) for more information.