Base64, TypedArrays, and UTF-8 / Unicode conversions in ES5.1 JavaScript (Browser and Node.js)
Go to file
AJ ONeal aafbc0e083 quickie tut for #7 2015-11-17 13:17:52 -08:00
.gitignore Initial commit 2015-05-18 12:02:27 -06:00
LICENSE Initial commit 2015-05-18 12:02:27 -06:00
README.md quickie tut for #7 2015-11-17 13:17:52 -08:00
bower.json bump 2015-10-23 03:13:58 -07:00
index.html add base32 support 2015-10-22 15:13:46 -07:00
index.js whitespace fix 2015-10-22 15:17:34 -07:00
node-test-base32.js add base32 support 2015-10-22 15:13:46 -07:00
node-test.js add some tests 2015-06-10 19:35:51 -06:00
test.js add base32 support 2015-10-22 15:13:46 -07:00
unibabel-dom.js v2.0 with proper encoding 2015-06-10 17:59:01 -06:00
unibabel-mozilla.js move index to unibabel-mozilla 2015-06-10 17:45:19 -06:00
unibabel.base32.js polyfill Mobile Safari's missing slice 2015-10-23 03:13:27 -07:00
unibabel.hex.js move index to unibabel-mozilla 2015-06-10 17:45:19 -06:00

README.md

Unibabel

Minimalistic Base64, TypedArrays, and UTF-8 / Unicode conversions in Browser (and Node) JavaScript. Optional add-on support for hex and base32.

See https://coolaj86.com/articles/base64-unicode-utf-8-javascript-and-you/

See also

Quick Note to Node.js Users

You SHOULD NOT use this module. You already have Buffer and thirty-two:

var buf = new Buffer('I ½ ♥ 💩', 'utf8');
buf.toString('hex');
buf.toString('base64');
buf.toString('ascii');
buf.toString('utf8');

API

// TypedArray <--> UTF8
var uint8Array = Unibabel.strToUtf8Arr(str);
var str = Unibabel.utf8ArrToStr(uint8Array);

// TypedArray <--> Base64
var base64 = Unibabel.arrToBase64(uint8Array)
var uint8Array = Unibabel.base64ToArr(base64)

Normal APIs

  • utf8ToBuffer(utf8str) => array

  • bufferToUtf8(array) => string

  • utf8ToBase64(utf8str) => base64

  • base64ToUtf8(base64) => string

  • bufferToBase64(array) => base64

  • base64ToBuffer(base64) => array

Hex APIs

unibabel.hex.js

  • hexToBuffer(hexstr) => array
  • bufferToHex(array) => hexstr

Base32 APIs

unibabel.base32.js

  • base32ToBuffer(b32str) => array
  • bufferToBase32(array) => b32str

Helper APIs

  • utf8ToBinaryString(utf8str) => binstr
  • binaryStringToUtf8(binstr) => utf8str
  • bufferToBinaryString(buffer) => binstr
  • binaryStringToBuffer(binstr) => array

Examples

// Base64

var myArray = Unibabel.base64ToArr("QmFzZSA2NCDigJQgTW96aWxsYSBEZXZlbG9wZXIgTmV0d29yaw=="); // "Base 64 \u2014 Mozilla Developer Network"
var myBuffer = Unibabel.base64ToArr("QmFzZSA2NCDigJQgTW96aWxsYSBEZXZlbG9wZXIgTmV0d29yaw==").buffer; // "Base 64 \u2014 Mozilla Developer Network"

console.log(myBuffer.byteLength);

// Crazy Unicode

var sMyInput = "I'm a ☢ ☃ that plays 𝄢 guitar and spea̧͈͖ks Ar̽̾̈́͒͑ ̶̧̨̱̹̭̯ͧ̾ͬC̷̙̲̝͖ͭ̏ͥͮ͟Oͮ͏̮̪̝͍M̲̖͊̒ͪͩͬ̚̚͜!";
var aMyUTF8Input = Unibabel.strToUtf8Arr(sMyInput);
var sMyBase64 = Unibabel.arrToBase64(aMyUTF8Input);

alert(sMyBase64);

var aMyUTF8Output = Unibabel.base64ToArr(sMyBase64);
var sMyOutput = Unibabel.utf8ArrToStr(aMyUTF8Output);

alert(sMyOutput);

License

  • index.js and unibabel.hex.js are dual-licensed as Apache 2.0 and MIT.
  • unibabel.base32.js is a modified version of thirty-two and is therefore licensed MIT.

Some parts of the code were taken from MDN, which Mozilla has licensed in the Public Domain, which means that I am at liberty to re-license my copy under the Apache 2 and MIT licenses.

See https://developer.mozilla.org/en-US/docs/MDN/About#Copyrights_and_licenses

ChangeLog

v2.1.0

Added unibabel.base32.js

v2.0.0

The new implementation is binary compatible with node.js, TextEncoder, and other more-common UTF-8 encodings.

It is also based on DOM APIs which result in much less code and are still backwards compatible all the way back to IE6 (not on purpose, just that it happens to work).

See https://coolaj86.com/articles/base64-unicode-utf-8-javascript-and-you/

v1.0.0

This version was based on the work by good folks at the MDN, however, the UTF-8 conversion was not byte-compatible with other UTF-8 conversions (such as node.js and TextEncoder), so don't use it. See https://developer.mozilla.org/en-US/docs/Web/API/WindowBase64/Base64_encoding_and_decoding