Playground

体验 Cloudflare Workers 最快的方式是使用 Playground ↗。它不需要任何设置或身份验证。Playground 是一个沙盒，让你可以直接在浏览器中预览和测试 Worker。

Playground 使用与已登录体验相同的编辑器。Playground 提供分享你编写的代码以及部署到 Cloudflare 全球网络的能力。这样，你可以尝试新功能，并在准备好时进行部署。

进入 Playground 后，你会看到以下默认代码：

import welcome from "welcome.html";

/**
 * @typedef {Object} Env
 */

export default {
	/**
	 * @param {Request} request
	 * @param {Env} env
	 * @param {ExecutionContext} ctx
	 * @returns {Response}
	 */
	fetch(request, env, ctx) {
		console.log("Hello Cloudflare Workers!");

		return new Response(welcome, {
			headers: {
				"content-type": "text/html",
			},
		});
	},
};

这是一个多模块 Worker 的示例：它接收一个 request，向控制台记录一条消息，然后返回包含 welcome.html 内容的 response 正文。

请参阅 Fetch handler 文档 了解更多信息。

当你编辑默认代码时，Worker 会自动更新，右侧的预览会显示 Worker 在浏览器中的运行效果，就像实际部署时一样。如果你的 Worker 使用 URL 路径，可以在右侧的输入字段中输入路径进行导航。Playground 通过 JSDoc 注释和 workers-types ↗ 提供类型检查。如果发生应用程序错误，Playground 还会提供格式化的错误页面。

要测试原始 HTTP 请求（例如测试 POST 请求），请转到 HTTP 选项卡并选择 Send（发送）。你可以通过此面板添加和编辑标头，也可以编辑请求正文。

Playground 和 Workers 仪表板中的快速编辑器在预览面板底部包含一个轻量级日志查看器。日志查看器显示预览运行期间任何 console.log 调用的输出。

日志查看器支持以下功能：

• 记录原始值、对象和数组。
• 在运行之间清除日志输出。

目前，日志查看器不支持记录类实例或其属性（例如 request.url）。

如果你需要具有完整调试功能的更完整开发体验，可以在本地使用 Wrangler。要从仪表板克隆现有 Worker 进行本地开发，请注册并使用 wrangler init --from-dash 命令（Worker 部署后）。

要分享你创建的内容，请选择屏幕右上角的 Copy Link（复制链接）。这会将唯一 URL 复制到剪贴板，你可以与任何人分享。这些链接不会过期，因此你可以随时为创作添加书签并分享。打开分享链接的用户将看到 Playground 中共享的代码和预览。

你可以从 Playground 部署 Worker。如果你已登录，可以在部署前查看 Worker。否则，你将经历首次用户引导流程，然后才能查看和部署。

部署后，你的 Worker 将获得唯一 URL，并几乎立即在 Cloudflare 全球网络上可用。从这里，你可以添加自定义域、存储资源等。