node_modules/iconv-lite/lib/index.js

   1 "use strict";
   2
   3 // Some environments don't have global Buffer (e.g. React Native).
   4 // Solution would be installing npm modules "buffer" and "stream" explicitly.
   5 var Buffer = require("safer-buffer").Buffer;
   6
   7 var bomHandling = require("./bom-handling"),
   8     iconv = module.exports;
   9
  10 // All codecs and aliases are kept here, keyed by encoding name/alias.
  11 // They are lazy loaded in `iconv.getCodec` from `encodings/index.js`.
  12 iconv.encodings = null;
  13
  14 // Characters emitted in case of error.
  15 iconv.defaultCharUnicode = '�';
  16 iconv.defaultCharSingleByte = '?';
  17
  18 // Public API.
  19 iconv.encode = function encode(str, encoding, options) {
  20     str = "" + (str || ""); // Ensure string.
  21
  22     var encoder = iconv.getEncoder(encoding, options);
  23
  24     var res = encoder.write(str);
  25     var trail = encoder.end();
  26
  27     return (trail && trail.length > 0) ? Buffer.concat([res, trail]) : res;
  28 }
  29
  30 iconv.decode = function decode(buf, encoding, options) {
  31     if (typeof buf === 'string') {
  32         if (!iconv.skipDecodeWarning) {
  33             console.error('Iconv-lite warning: decode()-ing strings is deprecated. Refer to https://github.com/ashtuchkin/iconv-lite/wiki/Use-Buffers-when-decoding');
  34             iconv.skipDecodeWarning = true;
  35         }
  36
  37         buf = Buffer.from("" + (buf || ""), "binary"); // Ensure buffer.
  38     }
  39
  40     var decoder = iconv.getDecoder(encoding, options);
  41
  42     var res = decoder.write(buf);
  43     var trail = decoder.end();
  44
  45     return trail ? (res + trail) : res;
  46 }
  47
  48 iconv.encodingExists = function encodingExists(enc) {
  49     try {
  50         iconv.getCodec(enc);
  51         return true;
  52     } catch (e) {
  53         return false;
  54     }
  55 }
  56
  57 // Legacy aliases to convert functions
  58 iconv.toEncoding = iconv.encode;
  59 iconv.fromEncoding = iconv.decode;
  60
  61 // Search for a codec in iconv.encodings. Cache codec data in iconv._codecDataCache.
  62 iconv._codecDataCache = {};
  63 iconv.getCodec = function getCodec(encoding) {
  64     if (!iconv.encodings)
  65         iconv.encodings = require("../encodings"); // Lazy load all encoding definitions.
  66
  67     // Canonicalize encoding name: strip all non-alphanumeric chars and appended year.
  68     var enc = iconv._canonicalizeEncoding(encoding);
  69
  70     // Traverse iconv.encodings to find actual codec.
  71     var codecOptions = {};
  72     while (true) {
  73         var codec = iconv._codecDataCache[enc];
  74         if (codec)
  75             return codec;
  76
  77         var codecDef = iconv.encodings[enc];
  78
  79         switch (typeof codecDef) {
  80             case "string": // Direct alias to other encoding.
  81                 enc = codecDef;
  82                 break;
  83
  84             case "object": // Alias with options. Can be layered.
  85                 for (var key in codecDef)
  86                     codecOptions[key] = codecDef[key];
  87
  88                 if (!codecOptions.encodingName)
  89                     codecOptions.encodingName = enc;
  90
  91                 enc = codecDef.type;
  92                 break;
  93
  94             case "function": // Codec itself.
  95                 if (!codecOptions.encodingName)
  96                     codecOptions.encodingName = enc;
  97
  98                 // The codec function must load all tables and return object with .encoder and .decoder methods.
  99                 // It'll be called only once (for each different options object).
 100                 codec = new codecDef(codecOptions, iconv);
 101
 102                 iconv._codecDataCache[codecOptions.encodingName] = codec; // Save it to be reused later.
 103                 return codec;
 104
 105             default:
 106                 throw new Error("Encoding not recognized: '" + encoding + "' (searched as: '"+enc+"')");
 107         }
 108     }
 109 }
 110
 111 iconv._canonicalizeEncoding = function(encoding) {
 112     // Canonicalize encoding name: strip all non-alphanumeric chars and appended year.
 113     return (''+encoding).toLowerCase().replace(/:\d{4}$|[^0-9a-z]/g, "");
 114 }
 115
 116 iconv.getEncoder = function getEncoder(encoding, options) {
 117     var codec = iconv.getCodec(encoding),
 118         encoder = new codec.encoder(options, codec);
 119
 120     if (codec.bomAware && options && options.addBOM)
 121         encoder = new bomHandling.PrependBOM(encoder, options);
 122
 123     return encoder;
 124 }
 125
 126 iconv.getDecoder = function getDecoder(encoding, options) {
 127     var codec = iconv.getCodec(encoding),
 128         decoder = new codec.decoder(options, codec);
 129
 130     if (codec.bomAware && !(options && options.stripBOM === false))
 131         decoder = new bomHandling.StripBOM(decoder, options);
 132
 133     return decoder;
 134 }
 135
 136
 137 // Load extensions in Node. All of them are omitted in Browserify build via 'browser' field in package.json.
 138 var nodeVer = typeof process !== 'undefined' && process.versions && process.versions.node;
 139 if (nodeVer) {
 140
 141     // Load streaming support in Node v0.10+
 142     var nodeVerArr = nodeVer.split(".").map(Number);
 143     if (nodeVerArr[0] > 0 || nodeVerArr[1] >= 10) {
 144         require("./streams")(iconv);
 145     }
 146
 147     // Load Node primitive extensions.
 148     require("./extend-node")(iconv);
 149 }
 150
 151 if ("Ā" != "\u0100") {
 152     console.error("iconv-lite warning: javascript files use encoding different from utf-8. See https://github.com/ashtuchkin/iconv-lite/wiki/Javascript-source-file-encodings for more info.");
 153 }