Open Playground
JS TutorialLesson #255

JavaScript Dynamic Modules

Dynamic Import uses the syntax:

JavaScript Dynamic Import

Dynamic Import uses the syntax:

import(module);

Dynamic Import was introduced in ECMAScript 2020 > Dynamic Import is a way to load JavaScript modules at runtime, > rather than at the start of your program.

Modern Software

Modern software splits imports into separate chunks.

Modules are downloaded only when requested - this method has many names:.

  • Dynamic Import
  • Code Splitting
  • Lazy Loading
  • Conditional Loading

Dynamic import is one of the most powerful features for modular and efficient code.

Unlike Static Import (which must appear at the top of a file), Dynamic Import can be used anywhere - inside functions, conditionals, event handlers, etc.

Syntax

Example Code

javascript
Try it Yourself
import("./module.js")
  • The argument must be a string or expression that resolves to a path
  • You must run the import inside a module script ( )
TypeExampleWhen Loaded
Staticimport { add } from './math.js';At load time
Dynamicconst math = await import('./math.js');When needed

Improved Performance

Modules can improve performance by allowing tools to implement "code splitting". This means that a user's browser only needs to load the JavaScript modules required for the specific features they are using at a given moment, rather than the entire application's code at once.

While modules themselves are a language feature, when combined with bundlers like Webpack or Rollup, they can lead to performance improvements through optimizations like tree-shaking (eliminating unused code), code splitting, and minification.


How Dynamic Import Works

Dynamic Modules use modern async/await:

Example

Example Code

javascript
Try it Yourself
async function run() {

  const module = await import("./math.js");

  let result = module.add(2, 3);

}

run();

Example Explained

  • The script starts running
  • It defines and calls run()
  • Inside run(), it dynamically loads math.js
  • Once loaded, it gets access to the exported function add()
  • It calls add(2, 3) and gets 5
  • It displays the result
StepCodeExplained
1async function run()Define a function that can use await
2await import("./math.js")Load the module file only when needed
3module.add(2, 3)Use the exported function from the module
4run()Start the process

Example

Example Code

javascript
Try it Yourself
async function run() {
  • This line defines an asynchronous function called run()
  • The async keyword means the function can use await inside it
  • The await keyword pauses the function until a Promise is resolved
  • In this case, the Promise is the import of the module

Example

Example Code

javascript
Try it Yourself
const module = await import("./math.js");
  • import("./math.js") defines a dynamic import
  • The module math.js is loaded on demand
  • math.js returns a Promise that resolves to its exported content
  • The await keyword waits until the module is fully loaded
  • Once loaded, the variable module contains the data exported from math.js

Example

Example Code

javascript
Try it Yourself
let result = module.add(2, 3);
  • Calls the exported function add() from the imported module
  • Passes in 2 and 3 as arguments
  • The function adds them and returns 5
  • The result is stored in result

Example

Example Code

javascript
Try it Yourself
run();

When it runs:

1. It loads the module math.js dynamically 2. It waits for the module to finish loading 3. It calls the add() function of the module 4. It displays the result


Another Example

Example

Example Code

javascript
Try it Yourself
async function run(x) {

  const module = await import("./temperatures.js");

  let celsius = module.toCelsius(x);

  document.getElementById("demo").textContent = celsius + " Celcius";

}

run(50);

Dynamic Import Key Features

  • Lazy Loading - Load code only when it is needed
  • Performance Optimization - Reduce initial load size for faster page load
  • Conditional Imports - Import different modules based on conditions.

Conditional Loading

Example

Example Code

javascript
Try it Yourself
if (user.isAdmin) {

  const adminTools = await import("./admin-tools.js");

  adminTools.init();

}

Interactive Code Examples

Syntax

javascript
Try it Yourself
JavaScript syntax and algorithm demonstration.
import("./module.js")

JS Example 2

javascript
Try it Yourself
JavaScript syntax and algorithm demonstration.
async function run() {

  const module = await import("./math.js");

  let result = module.add(2, 3);

}

run();

Example 3

javascript
Try it Yourself
JavaScript syntax and algorithm demonstration.
async function run() {

Example 4

javascript
Try it Yourself
JavaScript syntax and algorithm demonstration.
const module = await import("./math.js");

Example 5

javascript
Try it Yourself
JavaScript syntax and algorithm demonstration.
let result = module.add(2, 3);

Example 6

javascript
Try it Yourself
JavaScript syntax and algorithm demonstration.
run();