gulp-convert-encoding

4.0.0 • Public • Published

gulp-convert-encoding

NPM version Downloads Build Status Coveralls Status

Convert character encodings in gulp v4 using iconv-lite. Supports streams.

[!NOTE] As of gulp v5, this plugin is redundant: gulp v5 includes native support for transcoding text files using iconv-lite.

You can migrate away from this plugin by passing from and to as options.encoding to src and dest respectively. The default encoding is utf8.

Install

npm install --save-dev gulp-convert-encoding

Usage

import gulp from 'gulp';
import convertEncoding from 'gulp-convert-encoding';

export default () =>
	gulp
		.src('src/file.txt')
		.pipe(convertEncoding({ from: 'latin1' }))
		.pipe(gulp.dest('dist'));

API

convertEncoding(options)

[!IMPORTANT] You must provide one or both of the from and to options. Supported encodings are listed on the iconv-lite wiki.

options

Type: object

from

Type: string
Default: utf8

The current character encoding.

to

Type: string
Default: utf8

The target character encoding.

iconv

Type: object
Default: { decode: {}, encode: {} }

Allows you to pass additional options (e.g. for BOM Handling) into iconv-lite.

Package Sidebar

Install

npm i gulp-convert-encoding

Weekly Downloads

2,281

Version

4.0.0

License

MIT

Unpacked Size

7.73 kB

Total Files

5

Last publish

Collaborators

  • heldinz