FileSaver.js 5.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182
  1. /* FileSaver.js
  2. * A saveAs() FileSaver implementation.
  3. * 1.3.8
  4. * 2018-03-22 14:03:47
  5. *
  6. * By Eli Grey, https://eligrey.com
  7. * License: MIT
  8. * See https://github.com/eligrey/FileSaver.js/blob/master/LICENSE.md
  9. */
  10. /*global self */
  11. /*jslint bitwise: true, indent: 4, laxbreak: true, laxcomma: true, smarttabs: true, plusplus: true */
  12. /*! @source http://purl.eligrey.com/github/FileSaver.js/blob/master/src/FileSaver.js */
  13. var saveAs = saveAs || (function(view) {
  14. "use strict";
  15. // IE <10 is explicitly unsupported
  16. if (typeof view === "undefined" || typeof navigator !== "undefined" && /MSIE [1-9]\./.test(navigator.userAgent)) {
  17. return;
  18. }
  19. var
  20. doc = view.document
  21. // only get URL when necessary in case Blob.js hasn't overridden it yet
  22. , get_URL = function() {
  23. return view.URL || view.webkitURL || view;
  24. }
  25. , save_link = doc.createElementNS("http://www.w3.org/1999/xhtml", "a")
  26. , can_use_save_link = "download" in save_link
  27. , click = function(node) {
  28. var event = new MouseEvent("click");
  29. node.dispatchEvent(event);
  30. }
  31. , is_safari = /constructor/i.test(view.HTMLElement) || view.safari
  32. , is_chrome_ios =/CriOS\/[\d]+/.test(navigator.userAgent)
  33. , setImmediate = view.setImmediate || view.setTimeout
  34. , throw_outside = function(ex) {
  35. setImmediate(function() {
  36. throw ex;
  37. }, 0);
  38. }
  39. , force_saveable_type = "application/octet-stream"
  40. // the Blob API is fundamentally broken as there is no "downloadfinished" event to subscribe to
  41. , arbitrary_revoke_timeout = 1000 * 40 // in ms
  42. , revoke = function(file) {
  43. var revoker = function() {
  44. if (typeof file === "string") { // file is an object URL
  45. get_URL().revokeObjectURL(file);
  46. } else { // file is a File
  47. file.remove();
  48. }
  49. };
  50. setTimeout(revoker, arbitrary_revoke_timeout);
  51. }
  52. , dispatch = function(filesaver, event_types, event) {
  53. event_types = [].concat(event_types);
  54. var i = event_types.length;
  55. while (i--) {
  56. var listener = filesaver["on" + event_types[i]];
  57. if (typeof listener === "function") {
  58. try {
  59. listener.call(filesaver, event || filesaver);
  60. } catch (ex) {
  61. throw_outside(ex);
  62. }
  63. }
  64. }
  65. }
  66. , auto_bom = function(blob) {
  67. // prepend BOM for UTF-8 XML and text/* types (including HTML)
  68. // note: your browser will automatically convert UTF-16 U+FEFF to EF BB BF
  69. if (/^\s*(?:text\/\S*|application\/xml|\S*\/\S*\+xml)\s*;.*charset\s*=\s*utf-8/i.test(blob.type)) {
  70. return new Blob([String.fromCharCode(0xFEFF), blob], {type: blob.type});
  71. }
  72. return blob;
  73. }
  74. , FileSaver = function(blob, name, no_auto_bom) {
  75. if (!no_auto_bom) {
  76. blob = auto_bom(blob);
  77. }
  78. // First try a.download, then web filesystem, then object URLs
  79. var
  80. filesaver = this
  81. , type = blob.type
  82. , force = type === force_saveable_type
  83. , object_url
  84. , dispatch_all = function() {
  85. dispatch(filesaver, "writestart progress write writeend".split(" "));
  86. }
  87. // on any filesys errors revert to saving with object URLs
  88. , fs_error = function() {
  89. if ((is_chrome_ios || (force && is_safari)) && view.FileReader) {
  90. // Safari doesn't allow downloading of blob urls
  91. var reader = new FileReader();
  92. reader.onloadend = function() {
  93. var url = is_chrome_ios ? reader.result : reader.result.replace(/^data:[^;]*;/, 'data:attachment/file;');
  94. var popup = view.open(url, '_blank');
  95. if(!popup) view.location.href = url;
  96. url=undefined; // release reference before dispatching
  97. filesaver.readyState = filesaver.DONE;
  98. dispatch_all();
  99. };
  100. reader.readAsDataURL(blob);
  101. filesaver.readyState = filesaver.INIT;
  102. return;
  103. }
  104. // don't create more object URLs than needed
  105. if (!object_url) {
  106. object_url = get_URL().createObjectURL(blob);
  107. }
  108. if (force) {
  109. view.location.href = object_url;
  110. } else {
  111. var opened = view.open(object_url, "_blank");
  112. if (!opened) {
  113. // Apple does not allow window.open, see https://developer.apple.com/library/safari/documentation/Tools/Conceptual/SafariExtensionGuide/WorkingwithWindowsandTabs/WorkingwithWindowsandTabs.html
  114. view.location.href = object_url;
  115. }
  116. }
  117. filesaver.readyState = filesaver.DONE;
  118. dispatch_all();
  119. revoke(object_url);
  120. }
  121. ;
  122. filesaver.readyState = filesaver.INIT;
  123. if (can_use_save_link) {
  124. object_url = get_URL().createObjectURL(blob);
  125. setImmediate(function() {
  126. save_link.href = object_url;
  127. save_link.download = name;
  128. click(save_link);
  129. dispatch_all();
  130. revoke(object_url);
  131. filesaver.readyState = filesaver.DONE;
  132. }, 0);
  133. return;
  134. }
  135. fs_error();
  136. }
  137. , FS_proto = FileSaver.prototype
  138. , saveAs = function(blob, name, no_auto_bom) {
  139. return new FileSaver(blob, name || blob.name || "download", no_auto_bom);
  140. }
  141. ;
  142. // IE 10+ (native saveAs)
  143. if (typeof navigator !== "undefined" && navigator.msSaveOrOpenBlob) {
  144. return function(blob, name, no_auto_bom) {
  145. name = name || blob.name || "download";
  146. if (!no_auto_bom) {
  147. blob = auto_bom(blob);
  148. }
  149. return navigator.msSaveOrOpenBlob(blob, name);
  150. };
  151. }
  152. // todo: detect chrome extensions & packaged apps
  153. //save_link.target = "_blank";
  154. FS_proto.abort = function(){};
  155. FS_proto.readyState = FS_proto.INIT = 0;
  156. FS_proto.WRITING = 1;
  157. FS_proto.DONE = 2;
  158. FS_proto.error =
  159. FS_proto.onwritestart =
  160. FS_proto.onprogress =
  161. FS_proto.onwrite =
  162. FS_proto.onabort =
  163. FS_proto.onerror =
  164. FS_proto.onwriteend =
  165. null;
  166. return saveAs;
  167. }(
  168. typeof self !== "undefined" && self
  169. || typeof window !== "undefined" && window
  170. || this
  171. ));