Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cfware/fastify-babel

Fastify plugin for processing Javascript with babel.
https://github.com/cfware/fastify-babel

babel fastify fastify-plugin

Last synced: 29 days ago
JSON representation

Fastify plugin for processing Javascript with babel.

Awesome Lists containing this project

README

        

# fastify-babel [![NPM Version][npm-image]][npm-url]

Fastify Babel plugin for development servers

### Never load this plugin on production servers

The purpose of this module is for running a test HTTP server directly from
sources. Babel transformations are not async and all additional requests are
blocked while transformation is in process.

You should always use a build step to install pre-transformed files to production
servers.

### Install fastify-babel

This module requires node.js 10 or above. It is should normally be used
with `fastify-static >= 0.12.0`. This module requires the local filename
to be in `payload.filename`.

```sh
npm i --save-dev fastify-babel @babel/core
```

## Usage

```js
'use strict';

const path = require('path');
const fastify = require('fastify')();
const fastifyStatic = require('fastify-static');
const fastifyBabel = require('fastify-babel');

fastify
.register(fastifyStatic, {
root: path.join(__dirname, 'html/myapp'),
prefix: '/myapp',
})
.register(fastifyStatic, {
root: path.join(__dirname, 'node_modules'),
prefix: '/node_modules',
decorateReply: false,
})
.register(fastifyBabel, {
babelrc: {
plugins: ['bare-import-rewrite'],
},
})
.listen(3000, '127.0.0.1', err => {
if (err) {
throw err;
}
console.log(`server listening at http://127.0.0.1:${fastify.server.address().port}/`);
});
```

In addition to `fastify-babel` this example requires `fastify-static` and
`babel-plugin-bare-import-rewrite`.

## Options

### `babelrc`

An object provided directly to babel for each request that is processed.
Default is empty.

### `babelTypes`

A `RegExp` object used to match the `Content-Type` header. Only replies with
matching header will be processed by babel. Default `/(java|ecma)script/`.

### `maskError`

Setting this to `false` will allow the full error message to be displayed. By
default errors are masked to prevent disclosure of server details.

### `cache`

A Map-like object for caching transform results. This object must have support
for both `get` and `set` methods.

### `cacheHashSalt`

A string used to salt the hash of source content.

## `fastify-babel` for enterprise

Available as part of the Tidelift Subscription.

The maintainers of `fastify-babel` and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. [Learn more.](https://tidelift.com/subscription/pkg/npm-fastify-babel?utm_source=npm-fastify-babel&utm_medium=referral&utm_campaign=enterprise&utm_term=repo)

[npm-image]: https://img.shields.io/npm/v/fastify-babel.svg
[npm-url]: https://npmjs.org/package/fastify-babel