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."); | |||
|  | } |