unib64

This NodeJS package Converts an Unicode string to a Base64 string and vice versa.

The package is entirely based in The "Unicode Problem" solution as described into Mozilla Developers web (See References).

Use Cases

You may want to use unib64 to:

• Encode Unicode text to be transmitted among systems not supporting such charsets.
• Encode Unicode text to further be set within an environment variable.

Installation

If you only need this package's ESM module in your NodeJS app, then install it as dependency:

npm install unib64

Bonus: If you expect to use the CLI program provided by this package, you will need to globally install this package within your system.

npm install -g unib64

Usage

This package provides an ESM module alongside a command line interface, both supplying the same encode/decode features.

As CLI program

This package comes along with a command line program enabling you to use the same encode/decode features as those provided by the ESM module:

encode

$ unib64 encode "a Ā 𐀀 文 🦄"
YSDEgCDwkICAIOaWhyDwn6aE

decode

$ unib64 decode "YSDEgCDwkICAIOaWhyDwn6aE"
a Ā 𐀀 文 🦄

As ESM module

encode

import { encode } from 'unib64'

console.log(encode("a Ā 𐀀 文 🦄")) // YSDEgCDwkICAIOaWhyDwn6aE

decode

import { decode } from 'unib64'

console.log(decode("YSDEgCDwkICAIOaWhyDwn6aE")) // a Ā 𐀀 文 🦄

Tests

Open a terminal into this repository root directory and run the following command:

npm test

References

• The "Unicode Problem"