ファイルを置く第10章 ・ 読むのにかかる時間 約12分

整える​:一覧・削除・メタデータ

増えたファイルを扱えるようにする

ファイルは​増えます。
増えたら、​探せないと​意味が​ありません。

この章では並べる​・消す・情報を​持たせるの​3つを​覚えます。

地味ですが、​ここが​できた​瞬間に、​作った​ものが​急に​「使える​もの」に​なります。

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

  • R2に入っているファイルを一覧して、画面に並べる
  • いらないファイルを消す(そして消す怖さを知る)
  • ファイルに「撮影日」などの情報を一緒に持たせる
この章の内容(5節)
  1. 並べる:一覧を取る
  2. 消す:戻せないつもりで扱う
  3. 情報を持たせる:メタデータ
  4. 一覧を画面に並べる
  5. この章のまとめ

並べる​:一覧を​取る

倉庫に​ある​荷物の​札を、​順番に​読み上げて​もらう​操作です。

全部を​読み上げさせる​ことも​できますが、先頭が​一致する​ものだけに絞れます。

第7章で​キーを​ images/ で​始めたのは、​これの​ためです。

const listed = await env.BUCKET.list({ prefix: "images/" });
listed.objects.map((o) => o.key);   // キーの一覧

prefix(プレフィックス)

「この​文字で​始まる​ものだけ」と​いう​絞り込みです。

フォルダが​無い​R2では、​これが​フォルダの​代わりに​なります。

images/2026/ と​指定すれば、​2026年の​ぶんだけ​取り出せます。

最初に​キーの​付け方を​決めて​おいた​分、​ここで​楽が​できるわけです。

もう​1つ、​知っておいて​ほしい​ことがあります。

一覧は、​一度に​全部は​返ってきません。
数が​多いと​途中で​区切られて、​「続きが​あります」と​いう​印と​一緒に​返ります。

数百枚くらいまでは​意識せずに​済みますが、​増えたら​続きを​取る​作りが​必要に​なります。

Claude Codeにこう頼みます

R2に入っている画像の一覧を返す仕組みを作ってください。 ・images/ で始まるキーだけを対象にする ・キーと、ファイルの大きさと、アップロードされた日時を返す ・新しいものが先に来るように並べる ・件数が多いときに続きが取れる形にしておく(いまは実装だけで、使わなくてよい) 作ったら、確認用のURLを教えてください。

消す:戻せないつもりで​扱う

消す操作は​あっけない​ほど​簡単です。
だから​こそ、​先に​心構えを​書いて​おきます。

消した​ものは​戻って​こないつもりで​扱ってください。
ゴミ箱に​入るわけでは​ありません。

実用的な​対策は​2つです。

対策1消す前に、​対象を​必ず​表示させる

「これから​消すキーを​先に​見せてください」と​頼む習慣を​つけます

対策2本当に​消さず、​消したことに​する

非​表示の​印を​付けるだけの​方法です。
あとから​戻せます

この​章で​作るのは、​対策1の​「確認してから​消す」形。
Claude Codeにこう頼みます

画像を削除する仕組みを作ってください。ただし、事故を防ぐ作りにしてください。 ・削除する前に、対象のキーを画面に表示して、確認してから消す形にする ・一度に複数を消せる作りにはしないでください ・存在しないキーを消そうとしたときの動きも、日本語で説明してください 実装したら、どこが事故防止になっているのかを説明してください。

「削除」を押したあとに出る確認の実際の画面。「この画像を削除します。元に戻せません。」という文と、「やめる」「削除する」の2つのボタンがある
削除の​前に、​必ず​一度​止まる​作りに​しておくのが​コツです。

情報を​持た​せる​:メタデータ

写真​その​ものとは​別に、​「いつ​撮ったか」​「誰が​上げたか」を​一緒に​覚えさせられます。

これをメタデータと呼び、には​2種類あります。

決まった項目httpMetadataブラウザに​渡すための​情報

Content-Type など。
第8章・第9章で​使った​ものです

自分で​決めた​項目customMetadataあなたの​アプリの​ための​情報

撮影日・投稿者・タイトルなど。
短い​文字列を​数個まで

どちらも、​ファイルに​貼っておく​荷札のような​ものです。

便利ですが、​万能では​ありません。
メタデータで​検索する​ことは​できません
。

「撮影日が​10月の​ものを​出して」は​R2だけでは​無理です。

それを​やりたくなったら、​第7章で​出てきた(表)の​出番です。

倉庫R2写真そのもの

キーを​言えば、​その​1枚を​出してくれます

台帳D1撮影日・タイトルなど、​探すための​情報

「10月に​撮った​もの」のような​条件で​探せます

写真は​R2、​探すための​情報は​D1。​倉庫と​台帳の​関係です。

メタデータ

「データに​ついての​データ」の​こと。
写真​その​ものが​中身で、​撮影日や​撮影者が​メタデータです。

荷物と、​荷札に​書かれた​情報の​関係だと​思ってください。

一覧を​画面に​並べる

Claude Codeにこう頼みます

アップロード済みの画像を、トップページにサムネイル一覧として並べてください。 ・第9章で作った /file/ のURLを使って表示する ・新しいものが左上に来るようにする ・スマホでは2列、パソコンでは4列に並ぶようにする ・1枚もないときは「まだ画像がありません」と日本語で表示する 見た目はシンプルで構いません。作ったら確認用のURLを教えてください。

  1. 1アップロード第8章
  2. 2R2に保存名前と​種類を​持たせて
  3. 3一覧を取るprefix で​絞る
  4. 4/file/ で​表示第9章
  5. 5確認して削除増えたら​整理する
アップロードから​削除まで、​置く​・見せる​・​整えるが​一周しました。

これは​もう、​小さな​アプリです。

サムネイルが4列に並んだ画像一覧の実際の画面。各画像の下にファイルの大きさと「削除」ボタンがある
AIに​作って​もらった​一覧の​例です。​新しい​ものが​左上に​来て、​パソコンでは​4列に​並びます。​見た目は​あなたのものと​違って​構いません。

うまくいったか確認する

  • トップページに、​上げた​画像がで並ぶ
  • 新しく​上げた​画像が、​一覧の​先頭に​出てくる
  • 1枚消すと、​一覧からも​消える
  • スマホで​開くと​2列で​並ぶ

よくあるつまずき

一覧に出るのに、画像が壊れたマークになる

一覧の​キーと、​表示に​使っている​URLが​ずれています。

キーに / が​含まれる​ため、​URLの​組み立て方で​崩れがちです。

「一覧の​キーと​表示URLが​一致していません」と​伝えてください。

消したはずの画像が、まだ表示される
ブラウザが​前の​画像を​覚えています。
強制的に​再読み込みするか、​シークレットウィンドウで​確認してください。
古い画像が先に並んでしまう

一覧は​キーの​順で​返ってきます。
日付順に​したいなら、​並べ替えを​別に​指定する​必要が​あります。

「アップロード日時の​新しい​順に​並べ替えてください」と​頼んでください。

画像が増えたら、一覧の表示が遅くなった
全部を​一度に​読み込んでいます。
第11章で、​軽くして​速く​見せる​方法を​やります。

この章のまとめ

並べる​・消す・情報を​持たせる。
この​3つで、​倉庫が​「整理された​倉庫」に​なりました。

prefixで​絞る、​消す前に​見せる、​検索したくなったら​D1と​組む。

この​3点を​覚えておけば、​あとから​応用できます。

次の​章は、​見せ方の​仕上げです。
画像を​軽くして、​速く​届けます。

章末チェックリスト