https://github.com/mathiasbynens/iso-8859-2
A robust JavaScript implementation of the iso-8859-2 character encoding as defined by the Encoding Standard.
https://github.com/mathiasbynens/iso-8859-2
Last synced: 2 months ago
JSON representation
A robust JavaScript implementation of the iso-8859-2 character encoding as defined by the Encoding Standard.
- Host: GitHub
- URL: https://github.com/mathiasbynens/iso-8859-2
- Owner: mathiasbynens
- License: mit
- Created: 2014-05-06T13:01:22.000Z (about 11 years ago)
- Default Branch: main
- Last Pushed: 2023-01-31T16:01:04.000Z (over 2 years ago)
- Last Synced: 2025-03-28T22:24:47.001Z (3 months ago)
- Language: JavaScript
- Homepage: https://mths.be/iso-8859-2
- Size: 83 KB
- Stars: 8
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE-MIT.txt
Awesome Lists containing this project
README
# iso-8859-2 [](https://github.com/mathiasbynens/iso-8859-2/actions?query=workflow%3Arun-checks) [](https://www.npmjs.com/package/iso-8859-2)
_iso-8859-2_ is a robust JavaScript implementation of [the iso-8859-2 character encoding as defined by the Encoding Standard](https://encoding.spec.whatwg.org/#iso-8859-2).
This encoding is known under the following names: csisolatin2, iso-8859-2, iso-ir-101, iso8859-2, iso88592, iso_8859-2, iso_8859-2:1987, l2, and latin2.
## Installation
Via [npm](https://www.npmjs.com/):
```bash
npm install iso-8859-2
```
In a browser or in [Node.js](https://nodejs.org/):
```js
import {encode, decode, labels} from 'iso-8859-2';
// or…
import * as iso88592 from 'iso-8859-2';
```
## API
### `iso88592.labels`
An array of strings, each representing a [label](https://encoding.spec.whatwg.org/#label) for this encoding.
### `iso88592.encode(input, options)`
This function takes a plain text string (the `input` parameter) and encodes it according to iso-8859-2. The return value is an environment-agnostic `Uint16Array` of which each element represents an octet as per iso-8859-2.
```js
const encodedData = iso88592.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](https://encoding.spec.whatwg.org/#error-mode), 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.)
```js
const encodedData = iso88592.encode(text, {
mode: 'replacement'
});
// If `text` contains a symbol that cannot be represented in iso-8859-2,
// instead of throwing an error, it becomes 0xFFFD.
```
### `iso88592.decode(input, options)`
This function decodes `input` according to iso-8859-2. The `input` parameter can either be a `Uint16Array` of which each element represents an octet as per iso-8859-2, or a ‘byte string’ (i.e. a string of which each item represents an octet as per iso-8859-2).
```js
const text = iso88592.decode(encodedData);
```
The optional `options` object and its `mode` property can be used to set the [error mode](https://encoding.spec.whatwg.org/#error-mode). For decoding, the error mode can be `'replacement'` (the default) or `'fatal'`.
```js
const text = iso88592.decode(encodedData, {
mode: 'fatal'
});
// If `encodedData` contains an invalid byte for the iso-8859-2 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.](https://www.npmjs.com/browse/keyword/legacy-encoding)
## Author
| [](https://twitter.com/mathias "Follow @mathias on Twitter") |
|---|
| [Mathias Bynens](https://mathiasbynens.be/) |
## License
_iso-8859-2_ is available under the [MIT](https://mths.be/mit) license.