目录

• Base64
  • 可逆性
  • [m] encode
    • encode(o, encoding?)
  • [m] decode
    • decode(o, encoding?)

Base64#

Base64 是一种编码方式, 同时可作为一种数据的存储格式, 并非严格意义上的加密与解密.

base64 模块主要用于对数据进行 Base64 编码及解码.

注: 与 crypto 模块不同, crypto 模块主要用于信息的加密与解密.

参阅:
Wikipedia (英) / Wikipedia (中)
Base64 笔记 (from 阮一峰的网络日志)
Base64 是加密算法吗 (from 稀土掘金)

可逆性#

Base64 是一种可逆的编码方式:

console.log(base64.decode(base64.encode('orange'))); // orange
console.log(base64.decode(base64.encode('简体中文'))); // 简体中文

但需注意参数的字符编码方式 (默认为 UTF-8), 当存在超出编码表示范围的字符时, 可逆性将遭到破坏:

/* us-ascii 编码无法表示 "出" 和 "口". */
console.log(base64.decode(base64.encode('E2 出口', 'us-ascii'), 'us-ascii')); // E2 ??

编解码使用了不同的编码方式, 也可能导致可逆性失效:

/* utf-16 与 utf-8 不一致. */
console.log(base64.decode(base64.encode('简体中文', 'utf-16'), 'utf-8')); // ��{�OSN-e�

base64

[m] encode#

encode(o, encoding?)#

对数据进行 Base64 编码.

/* 字符串. */

console.log(base64.encode('hello', 'iso-8859-1')); // aGVsbG8=
console.log(base64.encode('hello', 'us-ascii')); // aGVsbG8=
console.log(base64.encode('hello', 'utf-8')); // aGVsbG8=
console.log(base64.encode('hello', 'utf-16')); // /v8AaABlAGwAbABv
console.log(base64.encode('hello', 'utf-16be')); // AGgAZQBsAGwAbw==
console.log(base64.encode('hello', 'utf-16le')); // aABlAGwAbABvAA==

/* JavaScript 字节数组. */

console.log(base64.encode([ 104, 101, 108, 108, 111 ], 'utf-8')); // aGVsbG8=

/* Java 字节数组. */

console.log(base64.encode(new java.lang.String('hello').getBytes(), 'utf-8')); // aGVsbG8=

let jsArr = [ 104, 101, 108, 108, 111 ];
let javaArr = util.java.array('byte', jsArr.length);
jsArr.forEach((o, i) => javaArr[i] = o);
console.log(base64.encode(javaArr, 'utf-8')); /* 效果同上. */

[m] decode#

decode(o, encoding?)#

对数据进行 Base64 解码.

/* 字符串. */

console.log(base64.decode('aGVsbG8=', 'iso-8859-1')); // hello
console.log(base64.decode('aGVsbG8=', 'us-ascii')); // hello
console.log(base64.decode('aGVsbG8=', 'utf-8')); // hello
console.log(base64.decode('/v8AaABlAGwAbABv', 'utf-16')); // hello
console.log(base64.decode('AGgAZQBsAGwAbw==', 'utf-16be')); // hello
console.log(base64.decode('aABlAGwAbABvAA==', 'utf-16le')); // hello

/* JavaScript 字节数组. */

console.log(base64.decode([ 97, 71, 86, 115, 98, 71, 56, 61 ], 'utf-8')); // hello

/* Java 字节数组. */

console.log(base64.decode(new java.lang.String('aGVsbG8=').getBytes(), 'utf-8')); // hello

let jsArr = [ 97, 71, 86, 115, 98, 71, 56, 61 ];
let javaArr = util.java.array('byte', jsArr.length);
jsArr.forEach((o, i) => javaArr[i] = o);
console.log(base64.decode(javaArr, 'utf-8')); /* 效果同上. */