2 * A saveAs() FileSaver implementation.
5 * By Eli Grey, http://eligrey.com
7 * See https://github.com/eligrey/FileSaver.js/blob/master/LICENSE.md
11 /*jslint bitwise: true, indent: 4, laxbreak: true, laxcomma: true, smarttabs: true, plusplus: true */
13 /*! @source http://purl.eligrey.com/github/FileSaver.js/blob/master/FileSaver.js */
16 // IE 10+ (native saveAs)
17 ||
(typeof navigator
!== "undefined" &&
18 navigator
.msSaveOrOpenBlob
&& navigator
.msSaveOrOpenBlob
.bind(navigator
))
22 // IE <10 is explicitly unsupported
23 if (typeof navigator
!== "undefined" &&
24 /MSIE
[1-9]\
./.test(navigator
.userAgent
)) {
29 // only get URL when necessary in case Blob.js hasn't overridden it yet
30 , get_URL
= function() {
31 return view
.URL || view
.webkitURL || view
;
33 , save_link
= doc
.createElementNS("http://www.w3.org/1999/xhtml", "a")
34 , can_use_save_link
= !view
.externalHost
&& "download" in save_link
35 , click
= function(node
) {
36 var event
= doc
.createEvent("MouseEvents");
38 "click", true, false, view
, 0, 0, 0, 0, 0
39 , false, false, false, false, 0, null
41 node
.dispatchEvent(event
);
43 , webkit_req_fs
= view
.webkitRequestFileSystem
44 , req_fs
= view
.requestFileSystem || webkit_req_fs || view
.mozRequestFileSystem
45 , throw_outside
= function(ex
) {
46 (view
.setImmediate || view
.setTimeout
)(function() {
50 , force_saveable_type
= "application/octet-stream"
53 , process_deletion_queue
= function() {
54 var i
= deletion_queue
.length
;
56 var file
= deletion_queue
[i];
57 if (typeof file
=== "string") { // file is an object URL
58 get_URL().revokeObjectURL(file
);
59 } else { // file is a File
63 deletion_queue
.length
= 0; // clear queue
65 , dispatch
= function(filesaver
, event_types
, event
) {
66 event_types
= [].concat(event_types
);
67 var i
= event_types
.length
;
69 var listener
= filesaver
["on" + event_types
[i]];
70 if (typeof listener
=== "function") {
72 listener
.call(filesaver
, event || filesaver
);
79 , FileSaver
= function(blob
, name
) {
80 // First try a.download, then web filesystem, then object URLs
84 , blob_changed
= false
87 , get_object_url
= function() {
88 var object_url
= get_URL().createObjectURL(blob
);
89 deletion_queue
.push(object_url
);
92 , dispatch_all
= function() {
93 dispatch(filesaver
, "writestart progress write writeend".split(" "));
95 // on any filesys errors revert to saving with object URLs
96 , fs_error
= function() {
97 // don't create more object URLs than needed
98 if (blob_changed ||
!object_url
) {
99 object_url
= get_object_url(blob
);
102 target_view
.location
.href
= object_url
;
104 window
.open(object_url
, "_blank");
106 filesaver
.readyState
= filesaver
.DONE
;
109 , abortable
= function(func
) {
111 if (filesaver
.readyState
!== filesaver
.DONE
) {
112 return func
.apply(this, arguments
);
116 , create_if_not_found
= {create
: true, exclusive
: false}
119 filesaver
.readyState
= filesaver
.INIT
;
123 if (can_use_save_link
) {
124 object_url
= get_object_url(blob
);
125 save_link
.href
= object_url
;
126 save_link
.download
= name
;
128 filesaver
.readyState
= filesaver
.DONE
;
132 // Object and web filesystem URLs have a problem saving in Google Chrome when
133 // viewed in a tab, so I force save with application/octet-stream
134 // http://code.google.com/p/chromium/issues/detail?id=91158
135 if (view
.chrome
&& type
&& type
!== force_saveable_type
) {
136 slice
= blob
.slice || blob
.webkitSlice
;
137 blob
= slice
.call(blob
, 0, blob
.size
, force_saveable_type
);
140 // Since I can't be sure that the guessed media type will trigger a download
141 // in WebKit, I append .download to the filename.
142 // https://bugs.webkit.org/show_bug.cgi?id=65440
143 if (webkit_req_fs
&& name
!== "download") {
146 if (type
=== force_saveable_type || webkit_req_fs
) {
153 fs_min_size
+= blob
.size
;
154 req_fs(view
.TEMPORARY
, fs_min_size
, abortable(function(fs
) {
155 fs
.root
.getDirectory("saved", create_if_not_found
, abortable(function(dir
) {
156 var save
= function() {
157 dir
.getFile(name
, create_if_not_found
, abortable(function(file
) {
158 file
.createWriter(abortable(function(writer
) {
159 writer
.onwriteend
= function(event
) {
160 target_view
.location
.href
= file
.toURL();
161 deletion_queue
.push(file
);
162 filesaver
.readyState
= filesaver
.DONE
;
163 dispatch(filesaver
, "writeend", event
);
165 writer
.onerror
= function() {
166 var error
= writer
.error
;
167 if (error
.code
!== error
.ABORT_ERR
) {
171 "writestart progress write abort".split(" ").forEach(function(event
) {
172 writer
["on" + event
] = filesaver
["on" + event
];
175 filesaver
.abort
= function() {
177 filesaver
.readyState
= filesaver
.DONE
;
179 filesaver
.readyState
= filesaver
.WRITING
;
183 dir
.getFile(name
, {create
: false}, abortable(function(file
) {
184 // delete file if it already exists
187 }), abortable(function(ex
) {
188 if (ex
.code
=== ex
.NOT_FOUND_ERR
) {
197 , FS_proto
= FileSaver
.prototype
198 , saveAs
= function(blob
, name
) {
199 return new FileSaver(blob
, name
);
202 FS_proto
.abort
= function() {
203 var filesaver
= this;
204 filesaver
.readyState
= filesaver
.DONE
;
205 dispatch(filesaver
, "abort");
207 FS_proto
.readyState
= FS_proto
.INIT
= 0;
208 FS_proto
.WRITING
= 1;
212 FS_proto
.onwritestart
=
213 FS_proto
.onprogress
=
217 FS_proto
.onwriteend
=
220 view
.addEventListener("unload", process_deletion_queue
, false);
221 saveAs
.unload
= function() {
222 process_deletion_queue();
223 view
.removeEventListener("unload", process_deletion_queue
, false);
227 typeof self
!== "undefined" && self
228 ||
typeof window
!== "undefined" && window
231 // `self` is undefined in Firefox for Android content script context
232 // while `this` is nsIContentFrameMessageManager
233 // with an attribute `content` that corresponds to the window
235 if (typeof module
!== "undefined" && module
!== null) {
236 module
.exports
= saveAs
;
237 } else if ((typeof define
!== "undefined" && define
!== null) && (define
.amd
!= null)) {
238 define([], function() {