• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1'use strict';
2
3var iconvLite = require('iconv-lite');
4// Load Iconv from an external file to be able to disable Iconv for webpack
5// Add /\/iconv-loader$/ to webpack.IgnorePlugin to ignore it
6var Iconv = require('./iconv-loader');
7
8// Expose to the world
9module.exports.convert = convert;
10
11/**
12 * Convert encoding of an UTF-8 string or a buffer
13 *
14 * @param {String|Buffer} str String to be converted
15 * @param {String} to Encoding to be converted to
16 * @param {String} [from='UTF-8'] Encoding to be converted from
17 * @param {Boolean} useLite If set to ture, force to use iconvLite
18 * @return {Buffer} Encoded string
19 */
20function convert(str, to, from, useLite) {
21    from = checkEncoding(from || 'UTF-8');
22    to = checkEncoding(to || 'UTF-8');
23    str = str || '';
24
25    var result;
26
27    if (from !== 'UTF-8' && typeof str === 'string') {
28        str = new Buffer(str, 'binary');
29    }
30
31    if (from === to) {
32        if (typeof str === 'string') {
33            result = new Buffer(str);
34        } else {
35            result = str;
36        }
37    } else if (Iconv && !useLite) {
38        try {
39            result = convertIconv(str, to, from);
40        } catch (E) {
41            console.error(E);
42            try {
43                result = convertIconvLite(str, to, from);
44            } catch (E) {
45                console.error(E);
46                result = str;
47            }
48        }
49    } else {
50        try {
51            result = convertIconvLite(str, to, from);
52        } catch (E) {
53            console.error(E);
54            result = str;
55        }
56    }
57
58
59    if (typeof result === 'string') {
60        result = new Buffer(result, 'utf-8');
61    }
62
63    return result;
64}
65
66/**
67 * Convert encoding of a string with node-iconv (if available)
68 *
69 * @param {String|Buffer} str String to be converted
70 * @param {String} to Encoding to be converted to
71 * @param {String} [from='UTF-8'] Encoding to be converted from
72 * @return {Buffer} Encoded string
73 */
74function convertIconv(str, to, from) {
75    var response, iconv;
76    iconv = new Iconv(from, to + '//TRANSLIT//IGNORE');
77    response = iconv.convert(str);
78    return response.slice(0, response.length);
79}
80
81/**
82 * Convert encoding of astring with iconv-lite
83 *
84 * @param {String|Buffer} str String to be converted
85 * @param {String} to Encoding to be converted to
86 * @param {String} [from='UTF-8'] Encoding to be converted from
87 * @return {Buffer} Encoded string
88 */
89function convertIconvLite(str, to, from) {
90    if (to === 'UTF-8') {
91        return iconvLite.decode(str, from);
92    } else if (from === 'UTF-8') {
93        return iconvLite.encode(str, to);
94    } else {
95        return iconvLite.encode(iconvLite.decode(str, from), to);
96    }
97}
98
99/**
100 * Converts charset name if needed
101 *
102 * @param {String} name Character set
103 * @return {String} Character set name
104 */
105function checkEncoding(name) {
106    return (name || '').toString().trim().
107    replace(/^latin[\-_]?(\d+)$/i, 'ISO-8859-$1').
108    replace(/^win(?:dows)?[\-_]?(\d+)$/i, 'WINDOWS-$1').
109    replace(/^utf[\-_]?(\d+)$/i, 'UTF-$1').
110    replace(/^ks_c_5601\-1987$/i, 'CP949').
111    replace(/^us[\-_]?ascii$/i, 'ASCII').
112    toUpperCase();
113}
114