Registry / devops / esbuild-plugin-import-assertions

esbuild-plugin-import-assertions

JSON →
library1.0.1jsnpmunverified

A plugin for esbuild that enables import assertion syntax (e.g. `import json from './foo.json' assert { type: 'json' }`) in your builds. Current stable version is 1.0.1. This plugin adds the ability to use the TC39 proposal for import assertions, which esbuild does not natively support. It works only with synchronous imports and requires `bundle: true`. Key differentiator: it fills a gap for users who need import assertions without switching to a different bundler like Webpack or Rollup.

devops
npm install esbuild-plugin-import-assertions
package ↗
INSTALL
IMPORT
SIG · ESBUILD-PLUGIN-IMP
E
esbuild-plugin-import-assertions
devopsjavascriptv1.0.1
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

importAssertPlugin
✓ import { importAssertPlugin } from 'esbuild-plugin-import-assertions'
✗ const { importAssertPlugin } = require('esbuild-plugin-import-assertions')
The package exports a named export, not a default. CommonJS require will not work as the package is ESM-only. Use dynamic import() if needed in CJS.
default export
✓ Not available. Use named import.
✗ import importAssertPlugin from 'esbuild-plugin-import-assertions'
There is no default export. Attempting to import it as default will result in undefined.

Demonstrates basic esbuild build with the import assertions plugin, requiring bundle: true.

import { importAssertPlugin } from 'esbuild-plugin-import-assertions'; import { build } from 'esbuild'; build({ entryPoints: ['./app.ts'], bundle: true, outfile: './lib/out.js', plugins: [importAssertPlugin], target: ['chrome100'] }).catch(() => process.exit(1));
Debug
Known issues
gotchaAsynchronous imports are not supported. Only static import statements with assertions will be handled.
fix
Rewrite dynamic import() calls with assertions as static imports if possible, or use an alternative approach.
affects: *
gotchaThe plugin requires that esbuild's 'bundle' option is set to true. Without it, the plugin will not transform imports.
fix
Set 'bundle: true' in the esbuild options.
affects: *
Errors
Common errors & fixes
Error: The package "esbuild-plugin-import-assertions" is not a CommonJS module, use dynamic import() instead.
Attempting to require the package in a CommonJS environment without using dynamic import.
fix
Use import() or change the project to ESM (type: 'module' in package.json).
TypeError: importAssertPlugin is not a function
Importing the default export instead of the named export 'importAssertPlugin'.
fix
Use named import: import { importAssertPlugin } from 'esbuild-plugin-import-assertions';
Error: Import assertions are not supported with dynamic imports
Using dynamic import() with import assertions, which the plugin does not support.
fix
Convert to static import statements.
Upgrade
Version history
1.0.1latest on npm
Audit
Dependencies

No dependency data recorded yet.

Agent activity
2 hits · last 30 days
node
2
Resources
packagehttps://www.npmjs.com/package/esbuild-plugin-import-assertions ↗
esbuild-plugin-import-assertions — npm install esbuild-plugin-import-assertions · libregistry