@borewit/text-codec

@borewit/text-codec

A lightweight text encoding/decoding polyfill for JavaScript engines (like Hermes) which lack support for certain TextEncoder / TextDecoder encoding types.

This module implements manual encoding and decoding for the most commonly used encodings, without pulling in large dependencies or experimental features.

✨ Features

Supported encodings:

• utf-8 / utf8
• utf-16le
• ascii
• latin1 / iso-8859-1
• windows-1252

📦 Installation

npm install @borewit/text-codec

📚 API Documentation

textDecode(bytes, encoding): string

Decodes binary data into a JavaScript string using the specified encoding.

Parameters

• bytes (Uint8Array) — The binary data to decode.
• encoding (SupportedEncoding, optional) — Encoding type. Defaults to "utf-8".

Returns

• string — The decoded text.

Example

import { textDecode } from "@borewit/text-encode";

const bytes = new Uint8Array([0x48, 0x65, 0x6c, 0x6c, 0x6f]);
const text = textDecode(bytes, "ascii");
console.log(text); // "Hello"

Encodes a JavaScript string into binary form using the specified encoding.

textEncode(input, encoding): Uint8Array

Parameters

• input (string) — The string to encode.
• encoding (SupportedEncoding, optional) — Encoding type. Defaults to "utf-8".

Returns

Uint8Array — The encoded binary data.

Example:

import { textEncode } from "@borewit/text-encode";

const bytes = textEncode("Hello", "utf-16le");
console.log(bytes); // Uint8Array([...])

📜 Licence

This project is licensed under the MIT License. Feel free to use, modify, and distribute as needed.