INTEGRITY Dokumentace

Playground

Nejrychlejší způsob, jak experimentovat s Cloudflare Workers, je v Playground. Nevyžaduje žádné nastavení ani ověřování. Playground je sandbox, který umožňuje okamžitě zobrazit náhled a otestovat Worker přímo v prohlížeči.

Playground používá stejný editor jako přihlášené prostředí. Playground umožňuje sdílet kód, který píšete, stejně jako deploy okamžitě do globální sítě Cloudflare. Díky tomu můžete zkoušet nové věci a nasadit je, až budete připraveni.

Spustit Playground

Hello Cloudflare Workers

Po otevření Playground uvidíte tento výchozí kód:

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",
			},
		});
	},
};

Toto je příklad vícemodulového Workeru, který přijímá požadavek, zapíše zprávu do konzole a poté vrátí odpověď tělo obsahující obsah z welcome.html.

Viz Dokumentace k handleru fetch a zjistěte více.

Použít Playground

Při úpravě výchozího kódu se Worker automaticky aktualizuje, takže náhled vpravo zobrazuje jeho běh přesně tak, jak by vypadal v prohlížeči. Pokud Worker používá cesty URL, můžete je zadat do vstupního pole vpravo a přejít na ně. Playground poskytuje kontrolu typů pomocí komentářů JSDoc a workers-types. Playground navíc v případě chyb aplikace zobrazuje přehledné chybové stránky.

Chcete-li otestovat nezpracovaný požadavek HTTP (například pro otestování POST požadavek), přejděte do HTTP kartu a vyberte Odeslat. V tomto panelu můžete přidávat a upravovat hlavičky a také upravovat tělo požadavku.

Prohlížeč protokolů

Playground a rychlý editor v dashboardu Workers obsahují odlehčený prohlížeč logů ve spodní části náhledového panelu. Prohlížeč logů zobrazuje výstup všech volání console.log provedené během preview běhů.

Prohlížeč logů podporuje následující:

V současnosti prohlížeč logů nepodporuje logování instancí tříd ani jejich vlastností (například request.url).

Pokud potřebujete komplexnější vývojářský zážitek s plnými možnostmi ladění, můžete použít Wrangler lokálně. Chcete-li si pro lokální vývoj naklonovat existující Worker z dashboardu, zaregistrujte se a použijte wrangler init --from-dash příkaz poté, co je váš worker nasazený.

Sdílet

Chcete-li sdílet to, co jste vytvořili, vyberte Kopírovat odkaz v pravém horním rohu obrazovky. Tím se do schránky zkopíruje jedinečná adresa URL, kterou můžete sdílet s kýmkoli. Tyto odkazy nikdy nevyprší, takže si svůj výtvor můžete uložit do záložek a kdykoli jej sdílet. Uživatelé, kteří sdílený odkaz otevřou, uvidí Playground se sdíleným kódem a náhledem.

Nasadit

Worker můžete nasadit přímo z Playgroundu. Pokud jste již přihlášeni, můžete si Worker před nasazením zkontrolovat. V opačném případě vás před kontrolou a nasazením provedeme úvodním procesem pro nové uživatele.

Jakmile Worker nasadíte, získá vlastní jedinečnou URL adresu a bude téměř okamžitě dostupný v globální síti Cloudflare. Odtud můžete přidat Custom Domains, prostředky úložiště, a další.