はじめての公開
Workerを動かす
アクセスされたら返事をする、小さなプログラム
前の章で公開したページは、置いてあるだけの紙です。
誰が見ても同じことしか書いてありません。
この章では、そこに「聞かれたら、その場で答えを作って返す係」を1人だけ雇います。
それがWorkerです。
この章でできるようになること
- 置いてあるページと、その場で作る答えの違いを、自分の目で見分ける
- アクセスされると今の時刻を返す、小さなWorkerを作って公開する
- 1つのURLの中で、静的なページとWorkerが同居していることを理解する
なぜ、置いてあるだけでは足りないのか
前の章のページに「ただいまの時刻」を出したいとします。
HTMLに直接時刻を書き込んでも、それは書いた瞬間の時刻のまま止まります。
1時間後に見た人にも、1時間前の時刻が出たまま。
第1章で出てきた「静的」と「動的」の違いが、ここで関わってきます。
時刻のように、聞かれた瞬間に決まるものは、あらかじめ紙に書いておくことができません。
聞かれてから作る必要があります。
その「聞かれてから作る係」がWorkerです。
- 1アクセスURLが届く
- 2Worker住所を見て振り分ける
-
/api/hello だったらその場で答えを作るいまの時刻など、毎回変わるものそれ以外だったら置いてあるページを返す第4章で公開したHTML
パス(住所の後ろの部分)
https://example.com/api/hello の /api/hello の部分です。
同じサイトの中の「どこ」を指しているかを表します。
Workerはこのパスを見て、「これは自分が答える」「これは置いてあるページを渡す」を決めているんです。
作ってもらう
第4章のフォルダをそのまま使います。
Claude Codeに開いた状態で、これを送ってください。
いまの静的サイトに、Workerを足してください。 ・/api/hello にアクセスされたら、いまの時刻とあいさつをJSONで返す ・それ以外のアクセスは、これまで通り public フォルダの中のページをそのまま返す ・wrangler.jsonc に main と assets の binding を追加してください 追加したあと、それぞれのファイルが何をしているのかを、プログラミングを知らない人にもわかるように日本語で説明してください。
できあがるプログラムは、驚くほど短いです。
要点は、この3行だけ。
if (url.pathname === "/api/hello") {
return new Response(...); // ここで答えを作る
}
return env.ASSETS.fetch(request); // それ以外は置いてあるページ
読めなくて大丈夫です。
ただ、「もし〜なら、こうする」「そうでなければ、こうする」という形は見えますよね。
プログラムは、大抵この積み重ねです。
JSON(ジェイソン)
コンピューター同士がデータをやりとりするときの、決まった書き方です。
{"message": "こんにちは"} のように、名前と値を並べて書きます。
人間が読んでも大体の意味が分かるので、広く使われています。
binding(バインディング)
Workerに「これを使っていいですよ」と持たせる権限のことです。
今回は「置いてあるページ一式を使っていい」という権限を渡しています。
第7章では、ここに「R2の倉庫を使っていい」という権限が増えます。
この本で1番大事な言葉の1つなので、覚えておくと後が楽です。
手元で動かして、目で見る
手元で動かして確認したいです。ローカルで起動して、トップページと /api/hello の両方のURLを教えてください。
2つのURLを、順番にブラウザで開いてみてください。
3つめは、必ずやってみてください。
http://localhost:8787/を開くこれまで通りの案内ページが出ます- 末尾に
/api/helloを付けて開く時刻の入った短い文字列が出ます /api/helloを何度か再読み込み時刻は毎回変わり、トップは変わりません


これが「静的」と「動的」の違いです。
言葉で読むより、この2つを交互に読み込んだほうが、体で分かります。
公開する
確認できたので、この変更をCloudflareに公開してください。公開後のURLと、/api/hello を確認するためのURLの両方を教えてください。
今度はログインを聞かれません。
第4章で承認済みだからです。
うまくいったか確認する
- 公開されたURLの末尾に
/api/helloを付けて開くと、時刻が表示される - 再読み込みするたびに、時刻が変わる
- URLの末尾に何も付けなければ、これまで通り案内ページが出る
- スマホから
/api/helloを開いても、同じように動く
いま起きたことの意味
あなたのURLは、もう「ただのページ」ではありません。
頼めば答えを返してくれる窓口を持ちました。
この窓口の中身を変えれば、いろいろなことができます。
フォームの送信を受け取る、外部のサービスに問い合わせる。
第8章でやる画像のアップロードの受け取りも、全部この形の延長線上です。
しかもこの処理は、世界中のCloudflareのコンピューターで動いています。
あなたは1台もサーバーを借りていません。
よくあるつまずき
- /api/hello を開いたら、案内ページが出てしまう
Workerが読み込まれていない可能性があります。
wrangler.jsonc に
mainの行が入っているか、Claude Codeに確認してもらってください。- env.ASSETS is undefined
「置いてあるページを使っていい」という権限(binding)が設定されていません。
assets の設定に
bindingが書かれているか確認してもらってください。- 公開したのに、古い内容のまま見える
ブラウザが前の結果を覚えている(キャッシュしている)ことがあります。
第1章で出てきたキャッシュです。ブラウザの再読み込みを強めにするか、シークレットウィンドウで開いてみてください。
- 日本語が文字化けする
返すときの文字の種類の指定が抜けています。
「日本語が化けるので、文字コードの指定を直してください」と頼めば直ります。
この章のまとめ
Workerを1つ足して、聞かれたときだけ答えを作る窓口を用意しました。
静的と動的が1つのURLに同居していて、Workerがパスを見て振り分けている状態です。
次の章では、覚えにくいURLを自分のドメインに変えます。
あわせて、お金の話にも数字で答えます。
章末チェックリスト
この章は読了です。次の第6章で、独自ドメインとお金の話をします。