← Cloudflare Workers / workers

Playground

Быстрее всего опробовать Cloudflare Workers можно в Playground ↗. Настройка или аутентификация не требуются. Playground представляет собой песочницу, которая позволяет мгновенно просматривать и тестировать Worker прямо в браузере.

Playground использует тот же редактор, что и в режиме с аутентификацией. Playground позволяет поделиться код, который вы пишете, а также deploy его мгновенно в глобальную сеть 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, который получает запрос, выводя сообщение в консоль, а затем возвращая ответ тело, содержащее содержимое из welcome.html.

См. Документация по обработчику fetch чтобы узнать больше.

По мере редактирования кода по умолчанию Worker автоматически обновляется, поэтому в панели предпросмотра справа видно, как он работал бы в браузере. Если Worker использует пути URL, вы можете вводить их в поле ввода справа, чтобы переходить по ним. Playground обеспечивает проверку типов через комментарии JSDoc и workers-types ↗. Playground также показывает удобные страницы ошибок при сбоях в приложении.

Чтобы протестировать необработанный HTTP-запрос (например, чтобы протестировать POST запрос), перейдите в HTTP и выберите Отправить. В этой панели можно добавлять и редактировать заголовки, а также изменять тело запроса.

Playground и быстрый редактор в панели управления Workers включают облегченный просмотрщик логов внизу панели предпросмотра. Он отображает вывод любых вызовов console.log сделанные во время предпросмотра.

Средство просмотра журналов поддерживает следующее:

• Вывод примитивных значений, объектов и массивов.
• Очистка вывода журнала между запусками.

На данный момент просмотр логов не поддерживает логирование экземпляров классов или их свойств (например, request.url).

Если вам нужен более полноценный процесс разработки с полными возможностями отладки, можно использовать Wrangler локально. Чтобы клонировать уже существующий Worker из панели управления для локальной разработки, зарегистрируйтесь и используйте wrangler init --from-dash команду после развёртывания Worker.

Чтобы поделиться результатом, выберите Копировать ссылку в правом верхнем углу экрана. Это скопирует в буфер обмена уникальный URL, которым можно поделиться с кем угодно. Эти ссылки не имеют срока действия, поэтому вы можете добавить свою работу в закладки и поделиться ею в любой момент. Пользователи, открывшие ссылку, увидят Playground с общим кодом и предпросмотром.

Worker можно развернуть прямо из Playground. Если вы уже выполнили вход, перед развёртыванием можно просмотреть Worker. В противном случае сначала откроется процесс знакомства для нового пользователя, а затем станут доступны просмотр и развёртывание.

После развертывания Worker получит собственный уникальный URL-адрес и станет доступен практически мгновенно в глобальной сети Cloudflare. Отсюда можно добавить Custom Domains, ресурсы хранения, и многое другое.