Encoding Map According to the WHATWG Encoding Standard

1npm i whatwg-encoding-mapper

This package is a fork of whatwg-encoding which remove the iconv-lite and decode method. Only gave the mapping in the Encoding Standard.

Data is from https://encoding.spec.whatwg.org/encodings.json

1const whatwgEncoding = require("whatwg-encoding-mapper");
2
3console.assert(whatwgEncoding.labelToName("latin1") === "windows-1252");
4console.assert(whatwgEncoding.labelToName("  CYRILLic ") === "ISO-8859-5");
5
6console.assert(whatwgEncoding.isSupported("IBM866") === true);
7
8// Not supported by the Encoding Standard
9console.assert(whatwgEncoding.isSupported("UTF-32") === false);
10
11// In the Encoding Standard, but this package can't decode it
12console.assert(whatwgEncoding.isSupported("x-mac-cyrillic") === false);
13
14console.assert(whatwgEncoding.getBOMEncoding(Buffer.from([0xFE, 0xFF])) === "UTF-16BE");
15console.assert(whatwgEncoding.getBOMEncoding(Buffer.from([0x48, 0x69])) === null);

API

• labelToName(label): performs the get an encoding algorithm and returns the resulting encoding's name, or null for failure
• isSupported(name): returns whether the encoding is one of the encodings of the Encoding Standard, and is an encoding that this package can decode (via iconv-lite)
• getBOMEncoding(buffer): sniffs the first 2–3 bytes of the supplied Buffer, returning one of the encoding names "UTF-8", "UTF-16LE", or "UTF-16BE" if the appropriate BOM is present, or null if no BOM is present

Unsupported encodings

if you use iconv-lite out of this package. check the document for updated and more accurate result.

supportedName list is generated using the iconv-lite in devDependencies setction in package.json

Credits

whatwg-encoding was originally based on the excellent work of @nicolashenry, in jsdom. It has since been pulled out into this separate package.

Alternatives

If you are looking for a JavaScript implementation of the Encoding Standard's TextEncoder and TextDecoder APIs, you'll want @inexorabletash's text-encoding package.