Skip to content

A robust JavaScript implementation of the koi8-r character encoding as defined by the Encoding Standard.

License

Notifications You must be signed in to change notification settings

mathiasbynens/koi8-r

Folders and files

NameName
Last commit message
Last commit date

Latest commit

fbfb272 · Dec 9, 2021

History

41 Commits
Jul 30, 2021
Jul 30, 2021
Dec 9, 2021
Nov 28, 2021
Sep 5, 2021
Jul 30, 2021
May 6, 2014
May 6, 2014
Sep 2, 2014
Sep 5, 2021
Dec 9, 2021
Dec 9, 2021
Dec 9, 2021

Repository files navigation

koi8-r Build status koi8-r on npm

koi8-r is a robust JavaScript implementation of the koi8-r character encoding as defined by the Encoding Standard.

This encoding is known under the following names: cskoi8r, koi, koi8, koi8-r, and koi8_r.

Installation

Via npm:

npm install koi8-r

In a browser or in Node.js:

import {encode, decode, labels} from 'koi8-r';
// or…
import * as koi8r from 'koi8-r';

API

koi8r.labels

An array of strings, each representing a label for this encoding.

koi8r.encode(input, options)

This function takes a plain text string (the input parameter) and encodes it according to koi8-r. The return value is an environment-agnostic Uint16Array of which each element represents an octet as per koi8-r.

const encodedData = koi8r.encode(text);

The optional options object and its mode property can be used to set the error mode. The two available error modes are 'fatal' (the default) or 'replacement'. (Note: This differs from the spec, which recognizes “fatal” and HTML” modes for encoders. The reason behind this difference is that the spec algorithm is aimed at producing HTML, whereas this library encodes into an environment-agnostic Uint16Array of bytes.)

const encodedData = koi8r.encode(text, {
  mode: 'replacement'
});
// If `text` contains a symbol that cannot be represented in koi8-r,
// instead of throwing an error, it becomes 0xFFFD.

koi8r.decode(input, options)

This function decodes input according to koi8-r. The input parameter can either be a Uint16Array of which each element represents an octet as per koi8-r, or a ‘byte string’ (i.e. a string of which each item represents an octet as per koi8-r).

const text = koi8r.decode(encodedData);

The optional options object and its mode property can be used to set the error mode. For decoding, the error mode can be 'replacement' (the default) or 'fatal'.

const text = koi8r.decode(encodedData, {
  mode: 'fatal'
});
// If `encodedData` contains an invalid byte for the koi8-r encoding,
// instead of replacing it with U+FFFD in the output, an error is thrown.

Notes

Similar modules for other single-byte legacy encodings are available.

Author

twitter/mathias
Mathias Bynens

License

koi8-r is available under the MIT license.

About

A robust JavaScript implementation of the koi8-r character encoding as defined by the Encoding Standard.

Resources

License

Stars

Watchers

Forks

Packages

No packages published