From c6fd9c65d68ca673b1cd9f6bfc1022dcc9848a56 Mon Sep 17 00:00:00 2001 From: Jordan Austin Date: Thu, 11 Jul 2013 13:38:50 -0700 Subject: [PATCH 1/5] Started rewriting README The goal is to begin making this more understandable for people confused about what FileSaver is and how it can work across all browsers. --- README.md | 35 +++++++++++------------------------ 1 file changed, 11 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index 532046e..1f7f12c 100644 --- a/README.md +++ b/README.md @@ -9,34 +9,21 @@ FileSaver.js is the solution to saving files on the client side, and is perfect webapps that need to generate files or for saving sensitive information that shouldn't be sent to an external server. + Supported Browsers ------------------ -* Internet Explorer 10+ - * Up to 600 MiB per blob - * **Supports filenames** -* Firefox - * Up to 800 MiB per blob - * **Supports filenames** -* Google Chrome - * Up to 345 MiB per blob - * **Supports filenames** -* Google Chrome for Android Beta - * **Supports filenames** -* Opera Next - * **Supports filenames** -* Safari 5+ - * Requires [Blob.js](https://github.com/eligrey/Blob.js) - * Does not support filenames -* Opera ≤15 - * Requires [Blob.js](https://github.com/eligrey/Blob.js) - * Does not support filenames -* Firefox <4 - * Requires [Blob.js](https://github.com/eligrey/Blob.js) - * Does not support filenames +| Browser | Support Type | Filenames | Size | Dependancies | +| ------------- | ------------- | ------------ | ---------- | ------------ | +| Firefox 20+ | Blob | Yes | 800MiB/per | None | +| Firefox ≤19 | dataURL | No | | [Blob.js](https://github.com/eligrey/Blob.js) | +| Google Chrome | Blob | Yes | 354MiB/per | None | +| IE 10+ | Blob | Yes | 600MiB/per | None | +| Opera Next | Blob | Yes | | None | +| Opera ≤15 | datURL | No | | [Blob.js](https://github.com/eligrey/Blob.js) | +| Safari ≤6 | dataURL | No | | [Blob.js](https://github.com/eligrey/Blob.js) | -Unlisted future versions of browsers will probably work too; I just haven't -tested them. +Note: Unlisted versions or browsers will probably work too; however only the ones listed above have been tested. Feature detection is possible: From 663e6fc97a114a5a6bb6c7f90290f05bc80a1ef6 Mon Sep 17 00:00:00 2001 From: Jordan Austin Date: Fri, 12 Jul 2013 11:18:52 -0700 Subject: [PATCH 2/5] Updated browser support table --- README.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 1f7f12c..7355295 100644 --- a/README.md +++ b/README.md @@ -9,19 +9,21 @@ FileSaver.js is the solution to saving files on the client side, and is perfect webapps that need to generate files or for saving sensitive information that shouldn't be sent to an external server. +It works by + Supported Browsers ------------------ -| Browser | Support Type | Filenames | Size | Dependancies | +| Browser | Constructs as | Filenames | Size | Dependancies | | ------------- | ------------- | ------------ | ---------- | ------------ | | Firefox 20+ | Blob | Yes | 800MiB/per | None | -| Firefox ≤19 | dataURL | No | | [Blob.js](https://github.com/eligrey/Blob.js) | -| Google Chrome | Blob | Yes | 354MiB/per | None | +| Firefox ≤ 19 | Blob | NO | | [Blob.js](https://github.com/eligrey/Blob.js) | +| Chrome | Blob | Yes | 345MiB/per | None | | IE 10+ | Blob | Yes | 600MiB/per | None | | Opera Next | Blob | Yes | | None | -| Opera ≤15 | datURL | No | | [Blob.js](https://github.com/eligrey/Blob.js) | -| Safari ≤6 | dataURL | No | | [Blob.js](https://github.com/eligrey/Blob.js) | +| Opera < 15 | datURL | NO | | [Blob.js](https://github.com/eligrey/Blob.js) | +| Safari ≤ 6 | dataURL | NO | | [Blob.js](https://github.com/eligrey/Blob.js) | Note: Unlisted versions or browsers will probably work too; however only the ones listed above have been tested. @@ -54,8 +56,7 @@ The standard W3C File API [`Blob`][3] interface is not available in all browsers }); Note: The standard HTML5 `canvas.toBlob()` method is not available in all browsers. -[canvas-toBlob.js][5] is a cross-browser `canvas.toBlob()` implementation that solves -this. +[canvas-toBlob.js][5] is a cross-browser `canvas.toBlob()` that polyfills this. ### Aborting a save From 424664d9780657f251a84674a369eecee639c8b1 Mon Sep 17 00:00:00 2001 From: Jordan Austin Date: Fri, 12 Jul 2013 11:32:56 -0700 Subject: [PATCH 3/5] Updates to README --- README.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 7355295..c6beb69 100644 --- a/README.md +++ b/README.md @@ -5,12 +5,10 @@ FileSaver.js implements the W3C `saveAs()` [FileSaver][1] interface in browsers not natively support it. There is a [FileSaver.js demo][2] that demonstrates saving various media types. -FileSaver.js is the solution to saving files on the client side, and is perfect for -webapps that need to generate files or for saving sensitive information that shouldn't be +FileSaver.js is the solution to saving files on the client-side, and is perfect for +webapps that need to generate files, or for saving sensitive information that shouldn't be sent to an external server. -It works by - Supported Browsers ------------------ From 17b3df3b72a788f71259eaf2267df14e9cce63e6 Mon Sep 17 00:00:00 2001 From: Jordan Austin Date: Fri, 12 Jul 2013 11:37:13 -0700 Subject: [PATCH 4/5] Added Chrome for Android to supported browser table --- README.md | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index c6beb69..db03ea1 100644 --- a/README.md +++ b/README.md @@ -13,15 +13,16 @@ sent to an external server. Supported Browsers ------------------ -| Browser | Constructs as | Filenames | Size | Dependancies | -| ------------- | ------------- | ------------ | ---------- | ------------ | -| Firefox 20+ | Blob | Yes | 800MiB/per | None | -| Firefox ≤ 19 | Blob | NO | | [Blob.js](https://github.com/eligrey/Blob.js) | -| Chrome | Blob | Yes | 345MiB/per | None | -| IE 10+ | Blob | Yes | 600MiB/per | None | -| Opera Next | Blob | Yes | | None | -| Opera < 15 | datURL | NO | | [Blob.js](https://github.com/eligrey/Blob.js) | -| Safari ≤ 6 | dataURL | NO | | [Blob.js](https://github.com/eligrey/Blob.js) | +| Browser | Constructs as | Filenames | Size | Dependancies | +| -------------- | ------------- | ------------ | ---------- | ------------ | +| Firefox 20+ | Blob | Yes | 800MiB/per | None | +| Firefox ≤ 19 | Blob | NO | | [Blob.js](https://github.com/eligrey/Blob.js) | +| Chrome | Blob | Yes | 345MiB/per | None | +| Chrome for Android | Blob | Yes | 345MiB/per | None | +| IE 10+ | Blob | Yes | 600MiB/per | None | +| Opera Next | Blob | Yes | | None | +| Opera < 15 | datURL | NO | | [Blob.js](https://github.com/eligrey/Blob.js) | +| Safari ≤ 6 | dataURL | NO | | [Blob.js](https://github.com/eligrey/Blob.js) | Note: Unlisted versions or browsers will probably work too; however only the ones listed above have been tested. From 5996094267f154cb1421731099da441734d16844 Mon Sep 17 00:00:00 2001 From: Jordan Austin Date: Fri, 12 Jul 2013 11:41:27 -0700 Subject: [PATCH 5/5] Updated Chrome for Android fields Removed file size note, since this hasn't beeb tested. Added note to v28 + on Chrome for Android. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index db03ea1..bf56683 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ Supported Browsers | Firefox 20+ | Blob | Yes | 800MiB/per | None | | Firefox ≤ 19 | Blob | NO | | [Blob.js](https://github.com/eligrey/Blob.js) | | Chrome | Blob | Yes | 345MiB/per | None | -| Chrome for Android | Blob | Yes | 345MiB/per | None | +| Chrome for Android v28+ | Blob | Yes | | None | | IE 10+ | Blob | Yes | 600MiB/per | None | | Opera Next | Blob | Yes | | None | | Opera < 15 | datURL | NO | | [Blob.js](https://github.com/eligrey/Blob.js) |