download.js 6.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167
  1. //download.js v4.2, by dandavis; 2008-2016. [MIT] see http://danml.com/download.html for tests/usage
  2. // v1 landed a FF+Chrome compat way of downloading strings to local un-named files, upgraded to use a hidden frame and optional mime
  3. // v2 added named files via a[download], msSaveBlob, IE (10+) support, and window.URL support for larger+faster saves than dataURLs
  4. // v3 added dataURL and Blob Input, bind-toggle arity, and legacy dataURL fallback was improved with force-download mime and base64 support. 3.1 improved safari handling.
  5. // v4 adds AMD/UMD, commonJS, and plain browser support
  6. // v4.1 adds url download capability via solo URL argument (same domain/CORS only)
  7. // v4.2 adds semantic variable names, long (over 2MB) dataURL support, and hidden by default temp anchors
  8. // https://github.com/rndme/download
  9. (function (root, factory) {
  10. if (typeof define === 'function' && define.amd) {
  11. // AMD. Register as an anonymous module.
  12. define([], factory);
  13. } else if (typeof exports === 'object') {
  14. // Node. Does not work with strict CommonJS, but
  15. // only CommonJS-like environments that support module.exports,
  16. // like Node.
  17. module.exports = factory();
  18. } else {
  19. // Browser globals (root is window)
  20. root.download = factory();
  21. }
  22. }(this, function () {
  23. return function download(data, strFileName, strMimeType) {
  24. var self = window, // this script is only for browsers anyway...
  25. defaultMime = "application/octet-stream", // this default mime also triggers iframe downloads
  26. mimeType = strMimeType || defaultMime,
  27. payload = data,
  28. url = !strFileName && !strMimeType && payload,
  29. anchor = document.createElement("a"),
  30. toString = function(a){return String(a);},
  31. myBlob = (self.Blob || self.MozBlob || self.WebKitBlob || toString),
  32. fileName = strFileName || "download",
  33. blob,
  34. reader;
  35. myBlob= myBlob.call ? myBlob.bind(self) : Blob ;
  36. if(String(this)==="true"){ //reverse arguments, allowing download.bind(true, "text/xml", "export.xml") to act as a callback
  37. payload=[payload, mimeType];
  38. mimeType=payload[0];
  39. payload=payload[1];
  40. }
  41. if(url && url.length< 2048){ // if no filename and no mime, assume a url was passed as the only argument
  42. fileName = url.split("/").pop().split("?")[0];
  43. anchor.href = url; // assign href prop to temp anchor
  44. if(anchor.href.indexOf(url) !== -1){ // if the browser determines that it's a potentially valid url path:
  45. var ajax=new XMLHttpRequest();
  46. ajax.open( "GET", url, true);
  47. ajax.responseType = 'blob';
  48. ajax.onload= function(e){
  49. download(e.target.response, fileName, defaultMime);
  50. };
  51. setTimeout(function(){ ajax.send();}, 0); // allows setting custom ajax headers using the return:
  52. return ajax;
  53. } // end if valid url?
  54. } // end if url?
  55. //go ahead and download dataURLs right away
  56. if(/^data:([\w+-]+\/[\w+.-]+)?[,;]/.test(payload)){
  57. if(payload.length > (1024*1024*1.999) && myBlob !== toString ){
  58. payload=dataUrlToBlob(payload);
  59. mimeType=payload.type || defaultMime;
  60. }else{
  61. return navigator.msSaveBlob ? // IE10 can't do a[download], only Blobs:
  62. navigator.msSaveBlob(dataUrlToBlob(payload), fileName) :
  63. saver(payload) ; // everyone else can save dataURLs un-processed
  64. }
  65. }else{//not data url, is it a string with special needs?
  66. if(/([\x80-\xff])/.test(payload)){
  67. var i=0, tempUiArr= new Uint8Array(payload.length), mx=tempUiArr.length;
  68. for(i;i<mx;++i) tempUiArr[i]= payload.charCodeAt(i);
  69. payload=new myBlob([tempUiArr], {type: mimeType});
  70. }
  71. }
  72. blob = payload instanceof myBlob ?
  73. payload :
  74. new myBlob([payload], {type: mimeType}) ;
  75. function dataUrlToBlob(strUrl) {
  76. var parts= strUrl.split(/[:;,]/),
  77. type= parts[1],
  78. decoder= parts[2] == "base64" ? atob : decodeURIComponent,
  79. binData= decoder( parts.pop() ),
  80. mx= binData.length,
  81. i= 0,
  82. uiArr= new Uint8Array(mx);
  83. for(i;i<mx;++i) uiArr[i]= binData.charCodeAt(i);
  84. return new myBlob([uiArr], {type: type});
  85. }
  86. function saver(url, winMode){
  87. if ('download' in anchor) { //html5 A[download]
  88. anchor.href = url;
  89. anchor.setAttribute("download", fileName);
  90. anchor.className = "download-js-link";
  91. anchor.innerHTML = "downloading...";
  92. anchor.style.display = "none";
  93. document.body.appendChild(anchor);
  94. setTimeout(function() {
  95. anchor.click();
  96. document.body.removeChild(anchor);
  97. if(winMode===true){setTimeout(function(){ self.URL.revokeObjectURL(anchor.href);}, 250 );}
  98. }, 66);
  99. return true;
  100. }
  101. // handle non-a[download] safari as best we can:
  102. if(/(Version)\/(\d+)\.(\d+)(?:\.(\d+))?.*Safari\//.test(navigator.userAgent)) {
  103. if(/^data:/.test(url)) url="data:"+url.replace(/^data:([\w\/\-\+]+)/, defaultMime);
  104. if(!window.open(url)){ // popup blocked, offer direct download:
  105. if(confirm("Displaying New Document\n\nUse Save As... to download, then click back to return to this page.")){ location.href=url; }
  106. }
  107. return true;
  108. }
  109. //do iframe dataURL download (old ch+FF):
  110. var f = document.createElement("iframe");
  111. document.body.appendChild(f);
  112. if(!winMode && /^data:/.test(url)){ // force a mime that will download:
  113. url="data:"+url.replace(/^data:([\w\/\-\+]+)/, defaultMime);
  114. }
  115. f.src=url;
  116. setTimeout(function(){ document.body.removeChild(f); }, 333);
  117. }//end saver
  118. if (navigator.msSaveBlob) { // IE10+ : (has Blob, but not a[download] or URL)
  119. return navigator.msSaveBlob(blob, fileName);
  120. }
  121. if(self.URL){ // simple fast and modern way using Blob and URL:
  122. saver(self.URL.createObjectURL(blob), true);
  123. }else{
  124. // handle non-Blob()+non-URL browsers:
  125. if(typeof blob === "string" || blob.constructor===toString ){
  126. try{
  127. return saver( "data:" + mimeType + ";base64," + self.btoa(blob) );
  128. }catch(y){
  129. return saver( "data:" + mimeType + "," + encodeURIComponent(blob) );
  130. }
  131. }
  132. // Blob but not URL support:
  133. reader=new FileReader();
  134. reader.onload=function(e){
  135. saver(this.result);
  136. };
  137. reader.readAsDataURL(blob);
  138. }
  139. return true;
  140. }; /* end download() */
  141. }));