Encode and decode base64 to and from Uint8Array
npm install uint8-base64[![NPM version][npm-image]][npm-url]
[![build status][ci-image]][ci-url]
[![Test coverage][codecov-image]][codecov-url]
[![npm download][download-image]][download-url]
You can find a lot of NPM libraries dealing with base64 encoding and decoding.
However, we could not find one that would have as input AND output an Uint8Array. This library does exactly this.
This library is pretty fast and will convert over 500 Mb per second in NodeJS as well as in the browser.
If you need at the end a text rather than an Uint8Array it is also extremely fast to convert the Uint8Array to text using a TextEncoder:
``js`
const base64 = encode(bytes);
const string = new TextDecoder('utf8').decode(base64);
$ npm i uint8-base64
`js
import { encode } from 'uint8-base64';
const result = encode(Uint8Array.from([65])); // an array containing 'A'
// result is Uint8Array(4) [ 81, 81, 61, 61 ] ('QQ==')
`
`js
import { encode } from 'uint8-base64';
const bytes = new Uint8Array(256 1024 1024).map((_, i) =>
Math.floor(Math.random() * 256),
);
console.time('base64');
const base64 = encode(bytes);
const string = new TextDecoder('utf8').decode(base64);
console.timeEnd('base64');
console.log(string.slice(0, 100));
`
This code takes 330ms on my MacBook pro M4 to encode 256Mb of data. The encoding itself takes 240ms while the conversion to text takes 50ms.
`js
import { decode } from '..';
const result = decode(Uint8Array.from([81, 81, 61, 61])); // an array containing 'QQ=='
// result is Uint8Array(1) [ 65 ] ('A')
``
The code was largely inspired by: https://gist.github.com/enepomnyaschih/72c423f727d395eeaa09697058238727
[npm-image]: https://img.shields.io/npm/v/uint8-base64.svg
[npm-url]: https://www.npmjs.com/package/uint8-base64
[ci-image]: https://github.com/cheminfo/uint8-base64/workflows/Node.js%20CI/badge.svg?branch=main
[ci-url]: https://github.com/cheminfo/uint8-base64/actions?query=workflow%3A%22Node.js+CI%22
[codecov-image]: https://img.shields.io/codecov/c/github/cheminfo/uint8-base64.svg
[codecov-url]: https://codecov.io/gh/cheminfo/uint8-base64
[download-image]: https://img.shields.io/npm/dm/uint8-base64.svg
[download-url]: https://www.npmjs.com/package/uint8-base64