Cloudflare Queue
Configure Cloudflare Queues and process named queues in Workers.
Use Cloudflare Queue when queue producers and consumers should run on Cloudflare Workers.
Configure Cloudflare
nuxt.config.ts
export default defineNuxtConfig({
modules: ['@vitehub/queue/nuxt'],
})
On Cloudflare hosting, ViteHub uses the Cloudflare queue provider automatically. Set queue.binding only when you need a specific queue binding name.
Define a queue
server/queues/welcome-email.ts
import { defineQueue } from '@vitehub/queue'
export default defineQueue(async (job) => {
return {
email: job.payload?.email,
}
}, {
concurrency: 5,
})
What changes on Cloudflare
| Concern | Behavior |
|---|---|
| Binding | ViteHub derives the queue binding automatically for discovered queues unless you override it. |
| Batch handling | Use queue.createBatchHandler({ onMessage, onError?, concurrency? }) when you need Cloudflare batch processing. |
| Local options | Put concurrency and onError directly inside defineQueue(..., options). |
Choose Cloudflare when your queue consumers should run in Workers and batch delivery matters.