Security News
Cloudflare Adds Security.txt Setup Wizard
Cloudflare has launched a setup wizard allowing users to easily create and manage a security.txt file for vulnerability disclosure on their websites.
@fal-works/esbuild-plugin-global-externals
Advanced tools
esbuild plugin for replacing imports with global variables.
The @fal-works/esbuild-plugin-global-externals npm package is designed to work with the esbuild bundler, allowing developers to exclude specific modules from the bundle and instead treat them as global variables provided at runtime. This is particularly useful for large libraries or frameworks that are included via a CDN or are already present in the global scope of the user's environment.
Exclude specific modules
This feature allows developers to exclude modules like React and ReactDOM from the bundle. These excluded modules are then accessed as global variables, which must be included in the global scope separately, typically via a script tag in HTML.
require('esbuild').build({
entryPoints: ['app.js'],
bundle: true,
outfile: 'out.js',
plugins: [
require('@fal-works/esbuild-plugin-global-externals')({
react: 'React',
'react-dom': 'ReactDOM'
})
]
});
Similar to @fal-works/esbuild-plugin-global-externals, this package provides functionality to exclude specific modules from esbuild bundles and map them to global variables. The main difference lies in the configuration options and possibly the implementation details, which might affect performance or compatibility with different versions of esbuild.
esbuild plugin for replacing imports with global variables.
Developed with: esbuild v0.8.40
Similar to (but not the same as) output.globals
option of Rollup. See also: evanw/esbuild#337
This:
import p5 from "p5";
new p5();
transpiles to:
// Here a variable `p5` should be defined globally (typically via UMD)
var p5_default = p5;
new p5_default();
import { globalExternals } from "@fal-works/esbuild-plugin-global-externals";
/** Mapping from module paths to global variables */
const globals = {
jquery: "$"
};
esbuild.build({
entryPoints: ["src/main.js"],
outfile: "dist/bundle.js",
bundle: true,
plugins: [globalExternals(globals)],
});
If you prefer RegExp
use globalExternalsWithRegExp()
instead, however note that the RegExp
you'll pass should be valid in Go language as well.
Instead of simply providing variable names only, you can pass ModuleInfo
objects to configure the loading behavior for each module.
Either "esm"
(default) or "cjs"
.
This determines the internal behavior of this plugin when loading modules (which affects the code after bundling as well).
globalExternals({
"someModulePath": {
varName: "someGlobalVar",
type: "cjs"
}
})
If type: "esm"
and also if you're doing named import with some modules in question, you have to tell which variables from each module should be importable.
Additionally, if you don't do default import/export, you can prevent emitting code for this with defaultExport: false
.
Both have no effects if type: "cjs"
(which should work fine with named imports as well).
globalExternals({
"someModulePath": {
varName: "someGlobalVar",
namedExports: ["someExportedVar"],
defaultExport: false
}
})
The example above enables the following even if type: "esm"
:
import { someExportedVar } from "someModulePath";
which transpiles to:
var someExportedVar = someGlobalVar.someExportedVar;
FAQs
esbuild plugin for replacing imports with global variables.
The npm package @fal-works/esbuild-plugin-global-externals receives a total of 2,044,888 weekly downloads. As such, @fal-works/esbuild-plugin-global-externals popularity was classified as popular.
We found that @fal-works/esbuild-plugin-global-externals demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Cloudflare has launched a setup wizard allowing users to easily create and manage a security.txt file for vulnerability disclosure on their websites.
Security News
The Socket Research team breaks down a malicious npm package targeting the legitimate DOMPurify library. It uses obfuscated code to hide that it is exfiltrating browser and crypto wallet data.
Security News
ENISA’s 2024 report highlights the EU’s top cybersecurity threats, including rising DDoS attacks, ransomware, supply chain vulnerabilities, and weaponized AI.