はじめての公開第05章 ・ 読むのにかかる時間 約9分

Workerを​動かす

アクセスされたら返事をする、小さなプログラム

前の​章で​公開した​ページは、​置いてあるだけの​紙です。
誰が​見ても​同じ​ことしか​書いてありません。

この​章では、​そこに「聞かれたら、​その場で​答えを​作って​返す係」を​1人だけ​雇います。
それが​Workerです。

この章でできるようになること

  • 置いてあるページと、その場で作る答えの違いを、自分の目で見分ける
  • アクセスされると今の時刻を返す、小さなWorkerを作って公開する
  • 1つのURLの中で、静的なページとWorkerが同居していることを理解する
この章の内容(6節)
  1. なぜ、置いてあるだけでは足りないのか
  2. 作ってもらう
  3. 手元で動かして、目で見る
  4. 公開する
  5. いま起きたことの意味
  6. この章のまとめ

なぜ、​置いてあるだけでは​足りないのか

前の​章の​ページに​「ただいまの​時刻」を​出したいとします。

HTMLに​直接時刻を​書き込んでも、​それは書いた​瞬間の​時刻のまま​止まります。

1時間後に​見た​人にも、​1時間前の​時刻が​出たまま。

第1章で​出てきた​「静的」と​「動的」の​違いが、​ここで​関わってきます。

時刻のように、​聞かれた​瞬間に​決まる​ものは、​あらかじめ紙に​書いておく​ことができません。

聞かれてから​作る​必要が​あります。

その​「聞かれてから​作る​係」が​Workerです。

  1. 1アクセスURLが届く
  2. 2Worker住所を​見て​振り分ける
  3. /api/hello だったらその​場で​答えを​作るいまの​時刻など、​毎回​変わる​もの
    それ以外だったら置いてある​ページを​返す第4章で​公開した​HTML
Workerは​受付です。​全部を​自分で​作るのではなく、​必要な​ときだけ​作って、​あとは​置いてある​ものを​渡します。

パス(住所の後ろの部分)

https://example.com/api/hello の /api/hello の部分です。

同じ​サイトの​中の​「どこ」を​指しているかを​表します。

Workerは​この​パスを​見て、​「これは​自分が​答える」​「これは​置いてある​ページを​渡す」を​決めているんです。

作ってもらう

第4章の​フォルダを​そのまま​使います。
Claude Codeに​開いた​状態で、​これを​送ってください。

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つなので、​覚えておくと​後が​楽です。

手元で​動かして、​目で​見る

Claude Codeにこう頼みます

手元で動かして確認したいです。ローカルで起動して、トップページと /api/hello の両方のURLを教えてください。

2つの​URLを、​順番に​ブラウザで​開いてみてください。
3つめは、​必ず​やってみてください。

  1. http://localhost:8787/ を開くこれまで​通りの​案内ページが​出ます
  2. 末尾に /api/hello を付けて開く時刻の​入った​短い​文字列が​出ます
  3. /api/hello を​何度か​再読み込み時刻は​毎回​変わり、​トップは​変わりません
再読み込み前/api/hello を開いた実際の画面。message と time と iso の3項目がJSONで表示されている
再読み込み後同じ /api/hello を再読み込みした実際の画面。time の値だけが数秒あとの時刻に変わっている
同じ​URLなのに、​time の​値だけが​変わっています。​これが​「その​場で​作る」と​いう​ことです。

これが​「静的」と​「動的」の​違いです。
言葉で​読むより、​この​2つを​交互に​読み込んだ​ほうが、​体で​分かります。

公開する

Claude Codeにこう頼みます

確認できたので、この変更をCloudflareに公開してください。公開後のURLと、/api/hello を確認するためのURLの両方を教えてください。

今度は​ログインを​聞かれません。
第4章で​承認済みだからです。

うまくいったか確認する

  • 公開された​URLの​末尾に​ /api/hello を​付けて​開くと、​時刻が​表示される
  • 再読み込みする​たびに、​時刻が​変わる
  • URLの​末尾に​何も​付けなければ、​これまで​通り案内ページが​出る
  • スマホから /api/hello を​開いても、​同じように​動く

いま起きた​ことの​意味

あなたの​URLは、​もう​「ただの​ページ」では​ありません。

頼めば​答えを​返してくれる​窓口を持ちました。

この​窓口の​中身を​変えれば、​いろいろな​ことができます。

フォームの​送信を​受け取る、​外部の​サービスに​問い合わせる。

第8章でやる画像の​アップロードの​受け取りも、​全部​この​形の​延長線上です。

しかも​この​処理は、​世界中の​Cloudflareの​コンピューターで​動いています。
あなたは1台もを​借りていません。

よくあるつまずき

/api/hello を開いたら、案内ページが出てしまう

Workerが​読み込まれていない​可能性が​あります。

に main の​行が​入っているか、​Claude Codeに​確認して​もらってください。

env.ASSETS is undefined

「置いてある​ページを​使っていい」と​いう​権限​(binding)が​設定されていません。

assets の​設定に​ binding が​書かれているか​確認して​もらってください。

公開したのに、古い内容のまま見える

ブラウザが​前の​結果を​覚えている​(している)​ことがあります。
第1章で​出てきた​キャッシュです。

ブラウザの​再読み込みを​強めに​するか、​シークレットウィンドウで​開いてみてください。

日本語が文字化けする

返すときの​文字の​種類の​指定が​抜けています。

「日本語が​化けるので、​文字コードの​指定を​直してください」と​頼めば​直ります。

この章のまとめ

Workerを​1つ足して、​聞かれた​ときだけ​答えを​作る​窓口を​用意しました。

静的と​動的が​1つの​URLに​同居していて、​Workerが​パスを​見て​振り分けている​状態です。

次の​章では、​覚えにくいURLを​自分のに変えます。

あわせて、お金の話にも​数字で​答えます。

章末チェックリスト