@i-xi-dev/ms932-encoder

A JavaScript Windows-31J encoder, implements Shift_JIS encoder defined in WHATWG Encoding Standard.

Installation

npm

$ npm i @i-xi-dev/ms932-encoder

import { Ms932Encoder } from "@i-xi-dev/ms932-encoder";

CDN

import { Ms932Encoder } from "https://unpkg.com/@i-xi-dev/ms932-encoder";

Usage

const encoder = new Ms932Encoder();

encoder.encode("あいうえお");
// → Uint8Array[ 0x82, 0xA0, 0x82, 0xA2, 0x82, 0xA4, 0x82, 0xA6, 0x82, 0xA8 ]

const bytes = new Uint8Array(10);
const { read, written } = encoder.encodeInto("あいうえお", bytes);
// → read: 5
//   written: 10
//   bytes: Uint8Array[ 0x82, 0xA0, 0x82, 0xA2, 0x82, 0xA4, 0x82, 0xA6, 0x82, 0xA8 ]

Encoding error handling

const encoder = new Ms932Encoder({ fatal: false }); // default

encoder.encode("𩸽");
// → Uint8Array[ 0x3F ]

const encoder = new Ms932Encoder({ fatal: true });

encoder.encode("𩸽");
// → throws Error.