js-base64 3.9.4 → 3.9.5

package/README.md

@@ -26,7 +26,7 @@ Locally…
 … or Directly from CDN.  In which case you don't even need to install.
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/js-base64@3.9.4/base64.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/js-base64@3.9.5/base64.min.js"></script>
 ```
 
 This good old way loads `Base64` in the global context (`window`).  Though `Base64.noConflict()` is made available, you should consider using ES6 Module to avoid tainting `window`.
@@ -49,14 +49,14 @@ or even remotely.
 ```html
 <script type="module">
 // note jsdelivr.net does not automatically minify .mjs
-import { Base64 } from 'https://cdn.jsdelivr.net/npm/js-base64@3.9.4/base64.mjs';
+import { Base64 } from 'https://cdn.jsdelivr.net/npm/js-base64@3.9.5/base64.mjs';
 </script>
 ```
 
 ```html
 <script type="module">
 // or if you prefer no Base64 namespace
-import { encode, decode } from 'https://cdn.jsdelivr.net/npm/js-base64@3.9.4/base64.mjs';
+import { encode, decode } from 'https://cdn.jsdelivr.net/npm/js-base64@3.9.5/base64.mjs';
 </script>
 ```
 
@@ -89,7 +89,7 @@ Base64.encodeURI(latin);          // ZGFua29nYWk
 Base64.btoa(latin);               // ZGFua29nYWk=
 Base64.btoa(utf8);                // raises exception
 Base64.fromUint8Array(u8s);       // ZGFua29nYWk=
-Base64.fromUint8Array(u8s, true); // ZGFua29nYW which is URI safe
+Base64.fromUint8Array(u8s, true); // ZGFua29nYWk which is URI safe
 Base64.encode(utf8);              // 5bCP6aO85by+
 Base64.encode(utf8, true)         // 5bCP6aO85by-
 Base64.encodeURI(utf8);           // 5bCP6aO85by-
@@ -117,6 +117,32 @@ Base64.isValid('--');   // true: or URL-safe
 Base64.isValid('+-');   // false: can't mix both
 ```
 
+### Base64 variants
+
+The default encoding uses the standard Base64 alphabet from
+[RFC 4648, section 4](https://www.rfc-editor.org/rfc/rfc4648.html#section-4).
+The URL-safe form in js-base64 uses the base64url alphabet from
+[section 5](https://www.rfc-editor.org/rfc/rfc4648.html#section-5) and omits padding.
+
+| Form | Characters for values 62 and 63 | Padding | Encoding methods |
+| --- | --- | --- | --- |
+| Standard Base64 | `+` and `/` | Trailing `=` as needed | `Base64.encode(text)`, `Base64.fromUint8Array(bytes)` |
+| URL-safe Base64 | `-` and `_` | Omitted | `Base64.encodeURI(text)`, `Base64.encode(text, true)`, `Base64.fromUint8Array(bytes, true)` |
+
+For example, these bytes show both the alphabet and padding differences:
+
+```javascript
+const bytes = new Uint8Array([251, 255]);
+Base64.fromUint8Array(bytes);       // '+/8='
+Base64.fromUint8Array(bytes, true); // '-_8'
+Base64.toUint8Array('+/8=');        // Uint8Array [251, 255]
+Base64.toUint8Array('-_8');         // Uint8Array [251, 255]
+```
+
+`Base64.decode()` and `Base64.toUint8Array()` accept both alphabets, with or
+without padding. Use `decode()` for UTF-8 text and `toUint8Array()` for bytes.
+Encoded output has no line wrapping; MIME or PEM line wrapping is not added.
+
 ### Built-in Extensions
 
 By default `Base64` leaves built-in prototypes untouched.  But you can extend them as below.
@@ -133,7 +159,7 @@ Base64.extendString();
 'ZGFua29nYWk='.fromBase64();  // dankogai
 '5bCP6aO85by+'.fromBase64();  // 小飼弾
 '5bCP6aO85by-'.fromBase64();  // 小飼弾
-'5bCP6aO85by-'.toUint8Array();// u8s above
+'5bCP6aO85by-'.toUint8Array();// UTF-8 bytes of '小飼弾'
 ```
 
 ```javascript
@@ -159,7 +185,7 @@ var pngBase64 =
   "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=";
 ```
 
-Which is a Base64-encoded 1x1 transparent PNG, **DO NOT USE** `Base64.decode(pngBase64)`.  Use `Base64.atob(pngBase64)` instead.  `Base64.decode()` decodes to UTF-8 string while `Base64.atob()` decodes to bytes, which is compatible to browser built-in `atob()` (Which is absent in node.js).  The same rule applies to the opposite direction.
+Which is a Base64-encoded 1x1 transparent PNG, **DO NOT USE** `Base64.decode(pngBase64)`.  Use `Base64.atob(pngBase64)` instead.  `Base64.decode()` decodes to UTF-8 string while `Base64.atob()` decodes to bytes, which is compatible to browser built-in `atob()`.  The same rule applies to the opposite direction.
 
 Or even better, `Base64.toUint8Array(pngBase64)`.
 

package/base64.js

@@ -23,7 +23,7 @@
    *
    * @author Dan Kogai (https://github.com/dankogai)
    */
-  var version = '3.9.4';
+  var version = '3.9.5';
   /**
    * @deprecated use lowercase `version`.
    */
@@ -72,7 +72,7 @@
    */
   var _btoa = typeof btoa === 'function' ? function (bin) { return btoa(bin); }
       : btoaPolyfill;
-  var _fromUint8Array = typeof Uint8Array.prototype.toBase64 === 'function' ? function (u8a) { return u8a.toBase64(); }
+  var _fromUint8Array = typeof Uint8Array.prototype.toBase64 === 'function' ? Function.prototype.call.bind(Uint8Array.prototype.toBase64)
       : function (u8a) {
           // cf. https://stackoverflow.com/questions/12710001/how-to-convert-uint8-array-to-base64-encoded-string/12713326#12713326
           var maxargs = 0x1000;

package/base64.mjs

@@ -9,7 +9,7 @@
  *
  * @author Dan Kogai (https://github.com/dankogai)
  */
-const version = '3.9.4';
+const version = '3.9.5';
 /**
  * @deprecated use lowercase `version`.
  */
@@ -58,7 +58,7 @@ const btoaPolyfill = (bin) => {
  */
 const _btoa = typeof btoa === 'function' ? (bin) => btoa(bin)
     : btoaPolyfill;
-const _fromUint8Array = typeof Uint8Array.prototype.toBase64 === 'function' ? (u8a) => u8a.toBase64()
+const _fromUint8Array = typeof Uint8Array.prototype.toBase64 === 'function' ? Function.prototype.call.bind(Uint8Array.prototype.toBase64)
     : (u8a) => {
         // cf. https://stackoverflow.com/questions/12710001/how-to-convert-uint8-array-to-base64-encoded-string/12713326#12713326
         const maxargs = 0x1000;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "js-base64",
-	"version": "3.9.4",
+	"version": "3.9.5",
 	"description": "Yet another Base64 transcoder in pure-JS",
 	"main": "base64.js",
 	"module": "base64.mjs",