@waiting/base64

Base64

Base64 encoding/decoding in pure JS on both modern Browsers and Node.js based on base64-js

Features

• Encoding input supports typeof string, number and bigint
• Encoding input supports ArrayBuffer or Uint8Array
• Encoding/Decoding via TextEncoder/TextDecoder under browser and Buffer under Node.js

Browser requirement

• Browsers which support TextEncoder and TextDecoder

Node.js requirement

• v10.4.0+ for bigint base64 encoding
• ICU installation for base64 decoding with encodeings other then utf-8 and utf-16le

Installing

npm install @waiting/base64

Usage

Encodeing

import { b64encode, b64fromBuffer } from '@waiting/base64'

b64encode('A') === 'QQ=='
b64encode('𠮷') === b64encode('\uD842\uDFB7') === b64encode('\u{20BB7}') // '8KCutw=='
b64encode('schöne') === 'c2Now7ZuZQ=='
// bigint
b64encode(1n) === b64encode(1) // 'MQ=='

const u8arr = Uint8Array.from([0xe4, 0xb8, 0xad, 0xe6, 0x96, 0x87])
b64fromBuffer(u8arr) === b64encode('中文')  // '5Lit5paH'

Decoding

import { b64decode } from '@waiting/base64'

b64decode('MQ==') === '1'

Testing

npm run test

# for browsers FireFox and Chrome
npm run test:browser

# for browsers all available on this client
cd .config && npm i
npm run browser:detect

Demos

• Browser
• Node.js

License

MIT

Languages

• English
• 中文

Changelog

4.1.0 (2019-06-12)

Features

• b64fromURLSafe() Convert URL-safe base64 string to base64 string (cf267ff)
• b64urlDecode() Decode URL-safe base64 to original string (a30ba9d)
• b64urlEncode() Encode to URL-safe base64 (0129fc7)