フォルダの中身を一覧CSVにする
選んだフォルダの中のファイルを、相対パス・サイズ・更新日時・拡張子の一覧にして、CSV(UTF-8・Shift_JIS)で保存します。ファイルの中身は読みません。
ここにフォルダやファイルをドラッグ&ドロップもできます。
このツールについて
手元のフォルダの中にどんなファイルがあるかを、CSVの一覧にします。大量のファイルが入ったフォルダの点検や、バックアップ前の棚卸し、納品物の一覧作りなどを想定しています。見るのはファイルの名前・場所・大きさ・更新日時・拡張子だけで、ファイルを開いて中身を読むことはしません。「フォルダを選ぶ」から選ぶと、サブフォルダの中まで再帰的にたどり、見つかったファイルすべてを一覧にします。フォルダの中にある空のフォルダ自体は、File APIがファイルの一覧しか返さない仕組み上、一覧には出てきません。
一覧にする列は、フォルダを選んだ地点を起点にした相対パス(サブフォルダは / で区切った形)、サイズ(バイト)、更新日時(端末のタイムゾーンでの年月日時分秒)、拡張子(ファイル名の最後の .以降。先頭が . だけの名前や拡張子が無い名前は空欄)です。並び順は相対パスの文字コード順です。画面には先頭1,000件までを表示し、それを超える分は件数だけを示しますが、ダウンロードするCSVには表示していない分も含めて全件が入ります。CSVの区切りはカンマ、改行はCRLFで、パスに読点や引用符、改行を含む場合はCSVの規則どおり引用符で囲みます。出力の文字コードはUTF-8(BOMの有無を選べます)とShift_JISから選べます。Shift_JISで表せない文字(絵文字など)を含むファイル名は「?」に置き換わり、元には戻せません。ダウンロードするファイル名は、フォルダ名が分かる場合は「フォルダ名.csv」、分からない場合は folder-list.csv です。
フォルダの選択(input要素のwebkitdirectory)は標準化された仕組みではなく、スマートフォンのブラウザなど、対応していない環境があります。対応していない場合は「フォルダを選ぶ」を押しても通常のファイル選択になることがあるため、代わりに「複数ファイルを選ぶ」から、調べたいファイルをまとめて選んでください。この方法では、ブラウザがサブフォルダの情報を渡さないため、一覧の相対パスはファイル名だけになり、サブフォルダの構造は分かりません。フォルダやファイルのドラッグ&ドロップにも対応していますが、これも対応状況はブラウザによって差があり、対応していない場合はドロップされたファイルだけを一覧にします。ファイルの数や大きさに上限は設けていません(非常に多い場合の動作は確かめていません)。
- 「フォルダを選ぶ」でフォルダを選ぶか、フォルダをまるごとドラッグ&ドロップします。サブフォルダの中まで再帰的に調べます。
- フォルダ選択に対応していない環境では、「複数ファイルを選ぶ」で、調べたいファイルを複数選びます(この場合、サブフォルダの構造は分かりません)。
- 一覧の件数と合計サイズ、先頭1,000件までのファイルの一覧(相対パス・サイズ・更新日時・拡張子)が表示されます。
- CSVの文字コードをUTF-8・Shift_JISから選びます。UTF-8の場合はBOMを付けるかどうかも選べます。
- 「(ファイル名)をダウンロード」を押すと、表示件数にかかわらず、見つかった全件を含むCSVが保存されます。
- Shift_JISを選んだときは、絵文字など置き換わる文字がないか、保存したCSVを開いて確認してください。
ブラウザ内で完結します
選んだフォルダの中身はサーバーに送っていません。ブラウザのFile APIで、各ファイルの名前・サイズ・更新日時(メタ情報)だけを読み、中身は一切読み込んでいません。ドラッグ&ドロップでフォルダを再帰的にたどる部分も、ブラウザ標準のFile and Directory Entries API(webkitGetAsEntry・createReader)を使っています。CSVの文字コード変換には、csv-encoding等でも使っているencoding-japaneseというライブラリを使っています。処理はすべて端末の中で終わるため、開発者ツールのネットワークタブを開いたままフォルダを選んで操作し、リクエストが増えないことで確認できます。
関連する解説
解説記事は準備中です。