esbuild-plugin-browserify-adapter

esbuild-plugin-browserify-adapter

Use Browserify transforms as esbuild plugins.

Installation

The package is released to npm as esbuild-plugin-browserify-adapter:

npm install esbuild-plugin-browserify-adapter -D

Usage

This adapter lets you use any existing Browserify transform as an esbuild plugin. The plugin function can be passed an arbitrary number of transforms. Just like with Browserify itself, options are passed by wrapping the transform in an array and appending the options to that list.

Please note: This module does not work with Browserify plugins.

Basic usage

const esbuild = require('esbuild')
const coffeeify = require('coffeeify') // any transform works
const browserifyAdapter = require('esbuild-plugin-browserify-adapter')

esbuild.build({
  entryPoints: ['./app.coffee'],
  bundle: true,
  plugins: [browserifyAdapter(coffeeify)],
  outdir: './public'
})

Passing options

const esbuild = require('esbuild')
const envify = require('envify') // any transform works
const browserifyAdapter = require('esbuild-plugin-browserify-adapter')

esbuild.build({
  entryPoints: ['./app.js'],
  bundle: true,
  plugins: [browserifyAdapter([envify, { BUNDLE_TIME: new Date().toJSON() }])],
  outdir: './public'
})

Passing multiple transforms

In case you need to use multiple transforms, pass all of them to the adapter at once. Just like in Browserify, they will be run in the order given.

const esbuild = require('esbuild')
const coffeeify = require('coffeeify') // any transform works
const envify = require('envify') // any transform works
const browserifyAdapter = require('esbuild-plugin-browserify-adapter')

esbuild.build({
  entryPoints: ['./app.coffee'],
  bundle: true,
  plugins: [browserifyAdapter(
    coffeeify,
    [envify, { BUNDLE_TIME: new Date().toJSON() }]
  )],
  outdir: './public'
})

Why?

This plugin can help you with gradually migrating a Browserify-based setup to an esbuild-based one without having to change everything at once. It is not intended to be used as a permanent solution unless your transform usage is very limited.

Releasing a new version

New versions can be released using npm version <patch|minor|major>.

License

Copyright 2021 Frederik Ring - Available under the Mozilla Public License 2.0

Changelog

0.1.5

• dc0e556 Run tests in GitHub actions
• 38d632b Big files are truncated inadvertently
• ca72664 Bump json5 from 1.0.1 to 1.0.2 (dependabot[bot])

  Bumps json5 from 1.0.1 to 1.0.2.

  • Release notes
  • Changelog
  • Commits

  updated-dependencies:

  • dependency-name: json5 dependency-type: indirect ...

  Signed-off-by: dependabot[bot] [e-mail]

• 13fe8f8 Bump minimatch from 3.0.4 to 3.1.2 (dependabot[bot])

  Bumps minimatch from 3.0.4 to 3.1.2.

  • Release notes
  • Commits

  updated-dependencies:

  • dependency-name: minimatch dependency-type: indirect ...

  Signed-off-by: dependabot[bot] [e-mail]

• e671b36 Bump minimist from 1.2.5 to 1.2.6 (dependabot[bot])

  Bumps minimist from 1.2.5 to 1.2.6.

  • Release notes
  • Commits

  updated-dependencies:

  • dependency-name: minimist dependency-type: indirect ...

  Signed-off-by: dependabot[bot] [e-mail]

• fb47b68 Bump path-parse from 1.0.6 to 1.0.7 (dependabot[bot])

  Bumps path-parse from 1.0.6 to 1.0.7.

  • Release notes
  • Commits

  updated-dependencies:

  • dependency-name: path-parse dependency-type: indirect ...

  Signed-off-by: dependabot[bot] [e-mail]

• 2e3cb4a Bump glob-parent from 5.1.1 to 5.1.2 (dependabot[bot])

  Bumps glob-parent from 5.1.1 to 5.1.2.

  • Release notes
  • Changelog
  • Commits

  updated-dependencies:

  • dependency-name: glob-parent dependency-type: indirect ...

  Signed-off-by: dependabot[bot] [e-mail]

• d0f151b run npm audit