iso-8859-15
iso-8859-15 is a robust JavaScript implementation of the iso-8859-15 character encoding as defined by the Encoding Standard.
This encoding is known under the following names: csisolatin9, iso-8859-15, iso8859-15, iso885915, iso_8859-15, and l9.
Installation
Via npm:
npm install iso-8859-15
Via Bower:
bower install iso-8859-15
Via Component:
component install mathiasbynens/iso-8859-15
In a browser:
<script src="iso-8859-15.js"></script>
In Narwhal, Node.js, and RingoJS:
var iso885915 = require('iso-8859-15');
In Rhino:
load('iso885915.js');
Using an AMD loader like RequireJS:
require(
{
'paths': {
'iso-8859-15': 'path/to/iso-8859-15'
}
},
['iso-8859-15'],
function(iso885915) {
console.log(iso885915);
}
);
API
iso885915.version
A string representing the semantic version number.
iso885915.labels
An array of strings, each representing a label for this encoding.
iso885915.encode(input, options)
This function takes a plain text string (the input
parameter) and encodes it according to iso-8859-15. The return value is a ‘byte string’, i.e. a string of which each item represents an octet as per iso-8859-15.
var encodedData = iso885915.encode(text);
The optional options
object and its mode
property can be used to set the error mode. For encoding, the error mode can be 'fatal'
(the default) or 'html'
.
var encodedData = iso885915.encode(text, {
'mode': 'html'
});
iso885915.decode(input, options)
This function takes a byte string (the input
parameter) and decodes it according to iso-8859-15.
var text = iso885915.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'
.
var text = iso885915.decode(encodedData, {
'mode': 'fatal'
});
Support
iso-8859-15 is designed to work in at least Node.js v0.10.0, Narwhal 0.3.2, RingoJS 0.8-0.9, PhantomJS 1.9.0, Rhino 1.7RC4, as well as old and modern versions of Chrome, Firefox, Safari, Opera, and Internet Explorer.
Unit tests & code coverage
After cloning this repository, run npm install
to install the dependencies needed for development and testing. You may want to install Istanbul globally using npm install istanbul -g
.
Once that’s done, you can run the unit tests in Node using npm test
or node tests/tests.js
. To run the tests in Rhino, Ringo, Narwhal, and web browsers as well, use grunt test
.
To generate the code coverage report, use grunt cover
.
Notes
Similar modules for other single-byte legacy encodings are available.
Author
License
iso-8859-15 is available under the MIT license.