Pure JS ESM Encodings Set for Browser and NodeJS. Auto-Generated from Unicode.org.
Features
- No dependencies.
- One file per encoding.
- Extension points to add custom encodings and add/modify symbol mappings (overrides).
- Graphic Mode ☺. IBM PC memory-mapped symbols for 0-31 control codes.
- Custom defaultChar or a callback for encode and decode functions.
- Native TextDecoder for supported encodings (ISO-8859-* and CP125*)
- Typescript friendly.
- Tiny: ~400 bytes per encoding, ~24KB of full bundle.mjs, ~9KB in gzip.
npm install iconv-tiny
or import from CDN without installation:
import { IconvTiny, aliases, encodings } from "https://unpkg.com/[email protected]/dist/iconv-tiny.bundle.mjs";
const iconvTiny = new IconvTiny(encodings, aliases);
const buf = iconvTiny.encode("Le malheur est notre plus grand maître.", "cp1252")
...- ISO-8859: 1,2,3,4,5,6,7,8,9,10,11,13,14,15,16
- CP: 037, 424, 437, 500, 737, 775, 850, 852, 855, 856, 857, 860, 861, 862, 863, 864, 865, 866, 869, 874, 875, 1006, 1026, 1250, 1251, 1252, 1253, 1254, 1255, 1256, 1257, 1258
- MAC: CYRILLIC, GREEK, ICELAND, LATIN2, ROMAN, TURKISH
- ATARIST, KOI8-R, KOI8-U, KZ1048, NEXTSTEP, US-ASCII
iconv-tiny output is identical to iconv-lite output, see tests/regression.test.mjs.
import { CP1251 } from "iconv-tiny/encodings/CP1251";
const cp1251 = CP1251.create();
const buf = cp1251.encode("Век живи — век учись.");
const str = cp1251.decode(buf);
console.log(buf); // [ 194, 229, 234, 32, 230, 232, ... ]
console.log(str); // Век живи — век учись.See more examples.
Encode 256KB text 10000 times:
iconv-lite: 5232 ms, 477.829 MB/s.
iconv-tiny: 5198 ms, 480.954 MB/s.
Decode 256KB array 10000 times:
iconv-lite: 18008 ms, 138.827 MB/s.
iconv-tiny: 21008 ms, 119.002 MB/s.
iconv-tiny: 12412 ms, 201.418 MB/s. <-- using native TextDecoder