acorn-dynamic-import

What is acorn-dynamic-import?

The acorn-dynamic-import package is a plugin for the Acorn JavaScript parser that adds support for parsing dynamic import() syntax. This allows developers to use the import() function to dynamically load modules in their JavaScript code, which can be useful for code splitting and lazy loading.

What are acorn-dynamic-import's main functionalities?

Parsing dynamic import() syntax

This feature allows the Acorn parser to understand and parse the dynamic import() syntax. The code sample demonstrates how to extend the Acorn parser with the acorn-dynamic-import plugin and parse a piece of JavaScript code that uses dynamic import().

const acorn = require('acorn');
const dynamicImport = require('acorn-dynamic-import').default;

const Parser = acorn.Parser.extend(dynamicImport);

const code = 'import("./module.js").then(module => { console.log(module); });';
const ast = Parser.parse(code, { ecmaVersion: 2020 });

console.log(ast);

Other packages similar to acorn-dynamic-import

babel-plugin-syntax-dynamic-import

The babel-plugin-syntax-dynamic-import package is a Babel plugin that allows Babel to parse the dynamic import() syntax. Unlike acorn-dynamic-import, which is a plugin for the Acorn parser, babel-plugin-syntax-dynamic-import is used with Babel to enable the parsing of dynamic imports during the transpilation process.

es-module-lexer

The es-module-lexer package is a fast, minimal lexer for ES module syntax, including dynamic import() statements. It is designed to be used in environments where performance is critical. Compared to acorn-dynamic-import, es-module-lexer is more focused on performance and minimalism, providing a lightweight solution for identifying ES module imports and exports.

README

Dynamic import support in acorn

This is plugin for Acorn - a tiny, fast JavaScript parser, written completely in JavaScript.

For more information, check out the proposal repo.

Usage

Importing this module gives you a plugin that can be used to extend an Acorn parser:

import Parser from 'acorn';
import dynamicImport from 'acorn-dynamic-import';

Parser.extend(dynamicImport).parse('import("something");');

To extend the AST walker for dynamic imports, you can injecting the new node type into acorn-walk like this:

import inject from 'acorn-dynamic-import/lib/walk';
import * as acornWalk from 'acorn-walk';

const walk = inject(acornWalk);

License

This plugin is issued under the MIT license.