JavaScriptでファイルをダウンロードする方法を現役エンジニアが解説【初心者向け】
初心者向けにJavaScriptでファイルをダウンロードする方法について現役エンジニアが解説しています。JavaScriptでファイルをダウンロードしてもらうには、Blobオブジェクトとwindow.URL.createObjectURLを使います。その後にlinkタグ(aタグ)に読み込みを設定します。
テックアカデミーマガジンは受講者数No.1のプログラミングスクール「テックアカデミー」が運営。初心者向けにプロが解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。 ※ アンケートモニター提供元：GMOリサーチ株式会社 調査期間：2021年8月12日～8月16日 調査対象：2020年8月以降にプログラミングスクールを受講した18～80歳の男女1,000名 調査手法：インターネット調査
JavaScriptでファイルをダウンロードする方法について解説します。実際のコードをもとに解説していきますので、理解を深めていきましょう。
また、入門向けのJavaSriptを学習できるサイトも紹介しているので、合わせてご覧ください。
そもそもJavaScriptについてよく分からないという方は、JavaScriptとは何なのかについて解説した記事を読むとさらに理解が深まります。
なお本記事は、TechAcademyのオンラインブートキャンプJavaScript/jQuery講座の内容をもとにしています。
今回は、JavaScriptに関する内容だね！
どういう内容でしょうか？
JavaScriptでファイルをダウンロードする方法について詳しく説明していくね！
お願いします！
ファイルをダウンロードする方法
既存のファイルをダウンロードする場合、<a> 要素のdownload属性(HTML5)を使用するのが簡便です。
<a href="./sample.text" download="万葉集.txt">ダウンロード</a>
JavaScriptで動的にファイルを生成してダウンロードを行うにはBlobオブジェクトとwindow.URL.createObjectURLメソッドを使用します。
var blob = new Blob(
[text],
{ "type": "text/plain" });
var url = window.URL.createObjectURL(blob);
Blobオブジェクトはファイルに似たオブジェクトで様々なデータ形式を扱えます。
Blobオブジェクトについて、詳しくは以下の記事を参考にしてください。
mozilla.org/ja/docs/Web/API/Blob
実際に書いてみよう
今回のサンプルプログラムでは、<a>要素のdownload属性と、Blobオブジェクト及びwindow.URL.createObjectURLメソッドを使用した例をご紹介します。
実行用に「sample.text」ファイルを作成しておきましょう。
sample.text
初春の令月（れいげつ）にして 気淑（よ）く風和（やはら）ぎ 梅は鏡前（けいぜん）の粉（ふん）を披（ひら）く、 蘭（らん）は珮後（はいご）の香（かう）を薫（くゆ）らす
ソースコードは以下のとおりです。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>sample</title>
</head>
<body>
<a href="./sample.text" download="万葉集.txt">ダウンロード(HTML5のdownload属性)</a><br>
<a href="#" id="link1" onclick="func1()" download="万葉集.txt">ダウンロード(文字列からファイルを作成-その1)</a><br>
<a href="#" id="link2" onclick="func2()">ダウンロード(文字列からファイルを作成-その2)</a><br>
<script language="javascript" type="text/javascript">
let text = '初春の令月（れいげつ）にして
気淑（よ）く風和（やはら）ぎ
梅は鏡前（けいぜん）の粉（ふん）を披（ひら）く、
蘭（らん）は珮後（はいご）の香（かう）を薫（くゆ）らす'
// 文字列からファイルを作成してダウンロードする(1)
function func1() {
var blob = new Blob(
[text],
{ "type": "text/plain" })
var url = window.URL.createObjectURL(blob)
document.getElementById('link1').href = url
}
// 文字列からファイルを作成してダウンロードする(2)
function func2() {
var blob = new Blob(
[text],
{ "type": "text/plain" })
let link = document.createElement('a')
link.href = window.URL.createObjectURL(blob)
link.download = '万葉集.txt'
link.click()
}
</script>
</body>
</html>
実行結果は以下のようになります。それぞれのリンクをクリックするとファイルがダウンロードされます。
筆者プロフィール
| 太田和樹（おおたかずき）
ITベンチャー企業のPM兼エンジニア 普段は主に、Web系アプリケーション開発のプロジェクトマネージャーとプログラミング講師を行っている。守備範囲はフロントエンド、モバイル、サーバサイド、データサイエンティストと幅広い。その幅広い知見を生かして、複数の領域を組み合わせた新しい提案をするのが得意。 開発実績：画像認識技術を活用した駐車場混雑状況把握（実証実験）、音声認識を活用したヘルプデスク支援システム、Pepperを遠隔操作するアプリの開発、大規模基幹系システムの開発・導入マネジメント 地方在住。仕事のほとんどをリモートオフィスで行う。通勤で消耗する代わりに趣味のDIYや家庭菜園、家族との時間を楽しんでいる。 |
内容分かりやすくて良かったです！
ゆかりちゃんも分からないことがあったら質問してね！
分かりました。ありがとうございます！
TechAcademyでは、初心者でもJavaScript・jQueryを使ったWebサービス公開を習得できるオンラインブートキャンプJavaScript/jQuery講座を開催しています。
挫折しない学習方法を知れる説明動画や、現役エンジニアとのビデオ通話とチャットサポート、学習用カリキュラムを体験できる無料体験も実施しているので、ぜひ参加してみてください。
