Encode/decode strings with node-iconv and iconv-lite
Clone or download
Latest commit 91ae950 Dec 23, 2015
Failed to load latest commit information.
lib Use loader module for Iconv Dec 23, 2015
test Use loader module for Iconv Dec 23, 2015
.gitignore initial import Aug 15, 2012
.travis.yml update travis config Dec 23, 2015
LICENSE Added LICENSE Aug 28, 2014
README.md Bumped version to v0.1.12 Dec 23, 2015
package.json Use loader module for Iconv Dec 23, 2015



encoding is a simple wrapper around node-iconv and iconv-lite to convert strings from one encoding to another. If node-iconv is not available for some reason, iconv-lite will be used instead of it as a fallback.

Build Status npm version


Install through npm

npm install encoding


Require the module

var encoding = require("encoding");

Convert with encoding.convert()

var resultBuffer = encoding.convert(text, toCharset, fromCharset);


  • text is either a Buffer or a String to be converted
  • toCharset is the characterset to convert the string
  • fromCharset (optional, defaults to UTF-8) is the source charset

Output of the conversion is always a Buffer object.


var result = encoding.convert("ÕÄÖÜ", "Latin_1");
console.log(result); //<Buffer d5 c4 d6 dc>

iconv support

By default only iconv-lite is bundled. If you need node-iconv support, you need to add it as an additional dependency for your project:

    "encoding": "*",
    "iconv": "*"