JavaScriptでファイルをダウンロードする方法を現役エンジニアが解説【初心者向け】

初心者向けにJavaScriptでファイルをダウンロードする方法について現役エンジニアが解説しています。JavaScriptでファイルをダウンロードしてもらうには、Blobオブジェクトとwindow.URL.createObjectURLを使います。その後にlinkタグ(aタグ)に読み込みを設定します。

TechAcademyマガジンはオンラインのプログラミングスクールTechAcademy [テックアカデミー]が運営する教育×テクノロジーのWebメディアです。初心者でもすぐ勉強できる記事が2,000以上あります。

JavaScriptでファイルをダウンロードする方法について解説します。実際のコードをもとに解説していきますので、理解を深めていきましょう。

また、入門向けのJavaSriptを学習できるサイトも紹介しているので、合わせてご覧ください。

 

なお本記事は、オンラインブートキャンプ フロントエンドコース(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>

 

実行結果は以下のようになります。それぞれのリンクをクリックするとファイルがダウンロードされます。

 

[PR] JavaScript・jQueryで挫折しない学習方法を動画で公開中

筆者プロフィール

太田和樹(おおたかずき)

ITベンチャー企業のPM兼エンジニア

普段は主に、Web系アプリケーション開発のプロジェクトマネージャーとプログラミング講師を行っている。守備範囲はフロントエンド、モバイル、サーバサイド、データサイエンティストと幅広い。その幅広い知見を生かして、複数の領域を組み合わせた新しい提案をするのが得意。

開発実績:画像認識技術を活用した駐車場混雑状況把握(実証実験)、音声認識を活用したヘルプデスク支援システム、Pepperを遠隔操作するアプリの開発、大規模基幹系システムの開発・導入マネジメント

地方在住。仕事のほとんどをリモートオフィスで行う。通勤で消耗する代わりに趣味のDIYや家庭菜園、家族との時間を楽しんでいる。

 

大石ゆかり

内容分かりやすくて良かったです!

田島悠介

ゆかりちゃんも分からないことがあったら質問してね!

大石ゆかり

分かりました。ありがとうございます!

 

また、TechAcademyではJavaScriptを使ってWebサービスを公開できるオンラインブートキャンプ フロントエンドコース(JavaScript・jQuery講座)を開催しています。

プログラミングの初心者でも受講可能です。Webサイトの表現の幅を広げたいという方はぜひご覧ください。

また、現役エンジニアから学べる無料のプログラミング体験会も実施しているので、ぜひ参加してみてください。