181 lines
6.2 KiB
JavaScript
181 lines
6.2 KiB
JavaScript
"use strict";
|
||
|
||
var Buffer = require("safer-buffer").Buffer;
|
||
|
||
var bomHandling = require("./bom-handling"),
|
||
iconv = module.exports;
|
||
|
||
// All codecs and aliases are kept here, keyed by encoding name/alias.
|
||
// They are lazy loaded in `iconv.getCodec` from `encodings/index.js`.
|
||
iconv.encodings = null;
|
||
|
||
// Characters emitted in case of error.
|
||
iconv.defaultCharUnicode = '<27>';
|
||
iconv.defaultCharSingleByte = '?';
|
||
|
||
// Public API.
|
||
iconv.encode = function encode(str, encoding, options) {
|
||
str = "" + (str || ""); // Ensure string.
|
||
|
||
var encoder = iconv.getEncoder(encoding, options);
|
||
|
||
var res = encoder.write(str);
|
||
var trail = encoder.end();
|
||
|
||
return (trail && trail.length > 0) ? Buffer.concat([res, trail]) : res;
|
||
}
|
||
|
||
iconv.decode = function decode(buf, encoding, options) {
|
||
if (typeof buf === 'string') {
|
||
if (!iconv.skipDecodeWarning) {
|
||
console.error('Iconv-lite warning: decode()-ing strings is deprecated. Refer to https://github.com/ashtuchkin/iconv-lite/wiki/Use-Buffers-when-decoding');
|
||
iconv.skipDecodeWarning = true;
|
||
}
|
||
|
||
buf = Buffer.from("" + (buf || ""), "binary"); // Ensure buffer.
|
||
}
|
||
|
||
var decoder = iconv.getDecoder(encoding, options);
|
||
|
||
var res = decoder.write(buf);
|
||
var trail = decoder.end();
|
||
|
||
return trail ? (res + trail) : res;
|
||
}
|
||
|
||
iconv.encodingExists = function encodingExists(enc) {
|
||
try {
|
||
iconv.getCodec(enc);
|
||
return true;
|
||
} catch (e) {
|
||
return false;
|
||
}
|
||
}
|
||
|
||
// Legacy aliases to convert functions
|
||
iconv.toEncoding = iconv.encode;
|
||
iconv.fromEncoding = iconv.decode;
|
||
|
||
// Search for a codec in iconv.encodings. Cache codec data in iconv._codecDataCache.
|
||
iconv._codecDataCache = {};
|
||
iconv.getCodec = function getCodec(encoding) {
|
||
if (!iconv.encodings)
|
||
iconv.encodings = require("../encodings"); // Lazy load all encoding definitions.
|
||
|
||
// Canonicalize encoding name: strip all non-alphanumeric chars and appended year.
|
||
var enc = iconv._canonicalizeEncoding(encoding);
|
||
|
||
// Traverse iconv.encodings to find actual codec.
|
||
var codecOptions = {};
|
||
while (true) {
|
||
var codec = iconv._codecDataCache[enc];
|
||
if (codec)
|
||
return codec;
|
||
|
||
var codecDef = iconv.encodings[enc];
|
||
|
||
switch (typeof codecDef) {
|
||
case "string": // Direct alias to other encoding.
|
||
enc = codecDef;
|
||
break;
|
||
|
||
case "object": // Alias with options. Can be layered.
|
||
for (var key in codecDef)
|
||
codecOptions[key] = codecDef[key];
|
||
|
||
if (!codecOptions.encodingName)
|
||
codecOptions.encodingName = enc;
|
||
|
||
enc = codecDef.type;
|
||
break;
|
||
|
||
case "function": // Codec itself.
|
||
if (!codecOptions.encodingName)
|
||
codecOptions.encodingName = enc;
|
||
|
||
// The codec function must load all tables and return object with .encoder and .decoder methods.
|
||
// It'll be called only once (for each different options object).
|
||
codec = new codecDef(codecOptions, iconv);
|
||
|
||
iconv._codecDataCache[codecOptions.encodingName] = codec; // Save it to be reused later.
|
||
return codec;
|
||
|
||
default:
|
||
throw new Error("Encoding not recognized: '" + encoding + "' (searched as: '"+enc+"')");
|
||
}
|
||
}
|
||
}
|
||
|
||
iconv._canonicalizeEncoding = function(encoding) {
|
||
// Canonicalize encoding name: strip all non-alphanumeric chars and appended year.
|
||
return (''+encoding).toLowerCase().replace(/:\d{4}$|[^0-9a-z]/g, "");
|
||
}
|
||
|
||
iconv.getEncoder = function getEncoder(encoding, options) {
|
||
var codec = iconv.getCodec(encoding),
|
||
encoder = new codec.encoder(options, codec);
|
||
|
||
if (codec.bomAware && options && options.addBOM)
|
||
encoder = new bomHandling.PrependBOM(encoder, options);
|
||
|
||
return encoder;
|
||
}
|
||
|
||
iconv.getDecoder = function getDecoder(encoding, options) {
|
||
var codec = iconv.getCodec(encoding),
|
||
decoder = new codec.decoder(options, codec);
|
||
|
||
if (codec.bomAware && !(options && options.stripBOM === false))
|
||
decoder = new bomHandling.StripBOM(decoder, options);
|
||
|
||
return decoder;
|
||
}
|
||
|
||
// Streaming API
|
||
// NOTE: Streaming API naturally depends on 'stream' module from Node.js. Unfortunately in browser environments this module can add
|
||
// up to 100Kb to the output bundle. To avoid unnecessary code bloat, we don't enable Streaming API in browser by default.
|
||
// If you would like to enable it explicitly, please add the following code to your app:
|
||
// > iconv.enableStreamingAPI(require('stream'));
|
||
iconv.enableStreamingAPI = function enableStreamingAPI(stream_module) {
|
||
if (iconv.supportsStreams)
|
||
return;
|
||
|
||
// Dependency-inject stream module to create IconvLite stream classes.
|
||
var streams = require("./streams")(stream_module);
|
||
|
||
// Not public API yet, but expose the stream classes.
|
||
iconv.IconvLiteEncoderStream = streams.IconvLiteEncoderStream;
|
||
iconv.IconvLiteDecoderStream = streams.IconvLiteDecoderStream;
|
||
|
||
// Streaming API.
|
||
iconv.encodeStream = function encodeStream(encoding, options) {
|
||
return new iconv.IconvLiteEncoderStream(iconv.getEncoder(encoding, options), options);
|
||
}
|
||
|
||
iconv.decodeStream = function decodeStream(encoding, options) {
|
||
return new iconv.IconvLiteDecoderStream(iconv.getDecoder(encoding, options), options);
|
||
}
|
||
|
||
iconv.supportsStreams = true;
|
||
}
|
||
|
||
// Enable Streaming API automatically if 'stream' module is available and non-empty (the majority of environments).
|
||
var stream_module;
|
||
try {
|
||
stream_module = require("stream");
|
||
} catch (e) {}
|
||
|
||
if (stream_module && stream_module.Transform) {
|
||
iconv.enableStreamingAPI(stream_module);
|
||
|
||
} else {
|
||
// In rare cases where 'stream' module is not available by default, throw a helpful exception.
|
||
iconv.encodeStream = iconv.decodeStream = function() {
|
||
throw new Error("iconv-lite Streaming API is not enabled. Use iconv.enableStreamingAPI(require('stream')); to enable it.");
|
||
};
|
||
}
|
||
|
||
if ("Ā" != "\u0100") {
|
||
console.error("iconv-lite warning: js files use non-utf8 encoding. See https://github.com/ashtuchkin/iconv-lite/wiki/Javascript-source-file-encodings for more info.");
|
||
}
|