@i-xi-dev/ms932-encoder

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

Requirement

Ms932.Encoder class

Chrome	Edge	Firefox	Safari	Deno	Node.js
✅	✅	✅	✅	✅	✅

Ms932.EncoderStream class

Ms932.EncoderStream requires TransformStream.

Chrome	Edge	Firefox	Safari	Deno	Node.js
✅	✅	✅ 102+	✅ 14.1+	✅	✅ 16.5+

Installation

npm

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

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

CDN

Example for UNPKG

1import { Ms932 } from "https://www.unpkg.com/@i-xi-dev/ms932-encoder@2.1.9/esm/mod.js";

Usage

Ms932.Encoder class

The Ms932.Encoder implements the TextEncoder interface.

1const encoder = new Ms932.Encoder();
2
3encoder.encode("あいうえお");
4// → Uint8Array[ 0x82, 0xA0, 0x82, 0xA2, 0x82, 0xA4, 0x82, 0xA6, 0x82, 0xA8 ]
5
6const bytes = new Uint8Array(10);
7const { read, written } = encoder.encodeInto("あいうえお", bytes);
8// → read: 5
9//   written: 10
10//   bytes: Uint8Array[ 0x82, 0xA0, 0x82, 0xA2, 0x82, 0xA4, 0x82, 0xA6, 0x82, 0xA8 ]

Encoding error handling

1const encoder = new Ms932.Encoder({ fatal: false }); // default
2
3encoder.encode("𩸽");
4// → Uint8Array[ 0x3F ]

1const encoder = new Ms932.Encoder({ replacementChar: "■" });
2
3encoder.encode("𩸽");
4// → Uint8Array[ 0x81, 0xA1 ]

1const encoder = new Ms932.Encoder({ fatal: true });
2
3encoder.encode("𩸽");
4// → throws TypeError.

Ms932.EncoderStream class

The Ms932.EncoderStream implements TextEncoderStream interface.

1const encoderStream = new Ms932.EncoderStream();
2
3// readableStream: ReadableStream<string>
4// writableStream: WritableStream<Uint8Array>
5readableStream.pipeThrough(encoderStream).pipeTo(writableStream);

Examples

• Windows-31J encode

FAQ

Q: Where is Ms932.Decoder?

A: Browsers and Node.js implement the Shift_JIS decoder. Use a TextDecoder.

1const decoder = new TextDecoder("shift_jis");