إعداد بيئة Worker

Welcome! Before we build our first Cloudflare Worker, we need to set up our local development environment. This ensures you have all the tools to write, test, and deploy your code efficiently.

A proper setup makes the development process smooth and helps you quickly iterate on your edge applications.

Our primary tool for interacting with Cloudflare Workers is the Wrangler CLI (Command Line Interface). It's a powerful tool that helps you:

• Create new Worker projects
• Develop and test Workers locally
• Configure and deploy Workers to Cloudflare's edge
• Manage Worker resources

Wrangler is built using Node.js, so you'll need Node.js and its package manager, npm (or yarn), installed on your machine.

• Node.js: A JavaScript runtime environment.
• npm: Node Package Manager, used to install libraries and tools.

If you don't have Node.js, download it from nodejs.org. We recommend using a Long Term Support (LTS) version.

Once Node.js and npm are ready, open your terminal or command prompt. We'll install Wrangler globally so it's accessible from any directory.

Run the following command:

After installing, you need to link Wrangler to your Cloudflare account. This allows Wrangler to deploy and manage Workers on your behalf.

Execute this command and follow the browser prompts to log in:

Now that Wrangler is installed and authenticated, let's create a new Worker project. This command generates a basic project structure for you.

Replace my-first-worker with your desired project name:

After running wrangler generate, you'll find a new directory (e.g., my-first-worker) with essential files:

• wrangler.toml: Your Worker's configuration file.
• src/index.js: The main JavaScript file where your Worker's logic lives.
• package.json: Standard Node.js package file (optional, for dependencies).

Let's dive into these key files.

The wrangler.toml file is crucial. It defines your Worker's settings, like its name, type, and associated Cloudflare account.

Here's a basic example of what it might contain:

The src/index.js file is where you write the JavaScript code for your Worker. Cloudflare Workers typically listen for fetch events.

This simple Worker responds with "Hello Cloudflare Workers!" to any request:

Before deploying, you can test your Worker right on your machine! Wrangler creates a local development server that simulates the Cloudflare edge environment.

Navigate into your project directory (e.g., cd my-first-worker) and run:

Which Wrangler command is used to connect your local environment to your Cloudflare account?

Great job! You've successfully set up your Cloudflare Workers development environment. You've learned how to:

• Install Wrangler CLI
• Authenticate with Cloudflare
• Generate a new Worker project
• Understand the basic project structure
• Run your Worker locally using wrangler dev

You're now ready to start building powerful applications at the edge!