Exciting news!Announcing our $4.6M Series Seed. Learn more
Socket
LoveBlogFAQ
Install
Log in

babel-plugin-include

Package Overview
Dependencies
0
Maintainers
1
Versions
3
Issues
File Explorer

Advanced tools

babel-plugin-include

Includes a file as a string literal

    1.2.0latest

Version published
Maintainers
1
Yearly downloads
6,579
increased by97.51%

Weekly downloads

Readme

Source

babel-plugin-include

Adds an include function which places the given file into a string at compile-time.

Installation

$ npm install babel-plugin-include

Usage

.babelrc

{ "plugins": ["include"] }

Via CLI

$ babel --plugins include script.js

Via Node API

require('babel').transform('code', { plugins: ['include'] });

Example

Given text.txt with the contents:

Hello, World!

the following JS:

let file = include("text.txt");

will be compiled to:

let file = "Hello, World!";

Information

  • The file is included relative to the JS file the include is in unless a root is specified in the plugin options, in which case, the root is used. (See below for info on root)
  • The default encoding is utf8 however that can be changed
  • Special characters/unprintables are automatically escaped
  • The include function takes a single string as argument. Any following arguments are ignored.

Options

babel-plugin-include allows you to change various settings by providing an options object by using the following instead:

{ plugins: [ ['include', { options }] ] }

where { options } is the options object. The following options are available:

root

The root option specifies the root in which files are included from. e.g.:

{ plugins: [ ['include', { 'root': 'proj/src' }] ] }

encoding

The encoding option specifies which encoding to use when including files. Default is utf8

{ plugins: [ ['include', { 'encoding': 'ucs2' }] ] }

normalizeNewline

The normalize newline option specifies whether newlines should be normalized or not. This converts \r\n to \n and removes and trailing newlines. Disable this for binary files or other applicable locations.

{ plugins: [ ['include', { 'encoding': 'ucs2' }] ] }

FAQs

What is babel-plugin-include?

Includes a file as a string literal

Is babel-plugin-include popular?

The npm package babel-plugin-include receives a total of 80 weekly downloads. As such, babel-plugin-include popularity was classified as not popular.

Is babel-plugin-include well maintained?

We found that babel-plugin-include demonstrated a not healthy version release cadence and project activity. It has 1 open source maintainer collaborating on the project.

Last updated on 28 Oct 2016
Socket

Product

Subscribe to our newsletter

Get open source security insights delivered straight into your inbox. Be the first to learn about new features and product updates.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc