bugl
bugl
HomeLearnPatternsPathsSearchPremium
HomeLearnPatternsPaths
Learn/JavaScript/Objects, Classes, and Advanced Patterns
JavaScript•Objects, Classes, and Advanced Patterns

JavaScript Modules Export

The Export Keyword

A module uses the export keyword to share values with other files.

A module can have many named exports .

A module can (optionally) have one default export .

Named Exports

A named export gives a name to each item .

Items can be exported individually , or wrapped in { } at the bottom:

Module File "person.js"

name and age exported individually:

// export name and age
export const name = "Jesse";
export const age = 40;

name and age exported at once at the bottom:

const name = "Jesse";
const age = 40;
// export name and age
export { name, age };

You import named exports by wrapping them in { } .

The names must match exactly.

<script type="module">
// Import name and age
import { name, age } from "./person.js";
</script>

Named exports enforce correct naming. If you misspell a name, you get an error.

Module File "math.js"

export const PI = 3.14159;
export function add(a, b) {
  return a + b;
}
export function subtract(a, b) {
  return a - b;
}
export function multiply(a, b) {
  return a * b;
}
export function divide(a, b) {
  return a / b;
}

Name Strictness

With named exports, the imported names must match exactly.

Name exports avoid mistakes caused by typos or renaming.

import { calcluate } from './math.js'; // ❌ error thrown

Toolbox Utilities (Helpers)

Utilities work best with named exports if they contain multiple helpers:

  • math.js
  • stringUtils.js
  • domHelpers.js
  • dateHelpers.js

Named exports are perfect for "toolbox" modules containing many utilities.

Tree-Shaking

Named exports enable bundlers to remove unused code (tree-shaking).

In this example PI, subract, multiply, and divide is removed:

import { add } from './math.js';

When to Use Named Export?

CasesWhy Named Export
Many functionsClearly lists all functions
Strictness neededPrevents name typos
Big projectsImproves consistency
Utility setsMatches module structure
Tree-shakingRemoves unused code automatically

Default Exports

Default Export exports one main value from a module.

This gives a clear intent about what the module's primary functionality is.

If a file is meant to expose one primary function, class, or value, default export makes that explicit:

export default function calculateSum() { ... }

You can have only one default export in a file.

Default is Flexible

Default exports let you import using any name :

import calc from './calculateSum.js';

The name calc does not need to match the original.

Compared to named exports, where the name must match exactly:

import { calculateSum } from './calculateSum.js';

Module File "message.js"

const message = () => {
  const name = "Jesse";
  const age = 40;
  return name + ' is ' + age + 'years old.';
};
export default message;

Default is Clean

Many libraries expose a single feature as the default:

import React from 'react';

Combining Default + Named

A module can provide one main function plus some helpers:

Module File

export default function parse() { ... }
export function validate() { ... }
export function format() { ... }

Module Script

import parse, { validate, format } from './parser.js';

When to Use Default Export?

WhenWhy
One main purposeGood for modules with a primary function
Flexible namingImporters can choose any name
Cleaner importsShorter and simpler import syntax
Common patternFrameworks use it for the main API

Previous

JavaScript Modules

Next

JavaScript Modules Import

This chapter

Overview
123

Lessons

539m

Read time

1. JavaScript Objects2. JavaScript Temporal Tutorial3. JavaScript Loops4. JavaScript Advanced Functions5. JavaScript Objects6. JavaScript Temporal Intro7. JavaScript Iterables8. JavaScript Function Definitions9. JavaScript Object Properties10. JavaScript Temporal vs Date11. JavaScript Iterators12. JavaScript Callbacks13. JavaScript Object Methods14. JavaScript Temporal Duration15. JavaScript Generators16. The JavaScript this Keyword17. JavaScript this Keyword18. JavaScript Temporal Instant19. JavaScript Function call()20. JavaScript Display Objects21. JavaScript PlainDateTime22. JavaScript Function apply()23. JavaScript Object Constructors24. JavaScript Temporal PlainDate25. JavaScript Function bind()26. JavaScript PlainYearMonth27. Self-Invoking Functions28. JavaScript PlainMonthDay29. JavaScript Closures30. JavaScript Temporal PlainTime31. JavaScript Objects - Advanced32. JavaScript ZonedDateTime33. JavaScript Object Definitions34. JavaScript Temporal Now35. this in JavaScript Objects36. JS Temporal Arithmetic37. JavaScript Object Iterations38. JS Temporal Differences39. JavaScript Object Accessors40. JS Temporal Compare41. JavaScript Object Management42. JavaScript Temporal Conversion43. JavaScript Object Protection44. Temporal Display Formats45. JavaScript Object Prototypes46. JavaScript Temporal Mistakes47. JavaScript Classes48. Migrate from Date to Temporal49. JavaScript Class Inheritance50. Temporal Standards51. JavaScript Static Methods52. Asynchronous JavaScript53. Asynchronous Programming54. JavaScript Timeouts55. JavaScript Callbacks56. JavaScript Promises57. JavaScript async and await58. JavaScript fetch API59. Debugging Async JavaScript60. JavaScript Modules61. JavaScript Modules Export62. JavaScript Modules Import63. JS Module Namespace64. JavaScript Dynamic Modules65. JavaScript Meta Programming66. JavaScript Reflect67. JavaScript Proxy68. JavaScript Typed Arrays69. Typed Array Methods70. JavaScript ArrayBuffer71. JavaScript DataView72. JavaScript Atomics73. JavaScript HTML DOM Navigation74. JavaScript HTML DOM Elements (Nodes)75. JavaScript HTML DOM Collections76. JavaScript HTML DOM Node Lists77. JavaScript Window - The Browser Object Model78. JavaScript Window Screen79. JavaScript Window Location80. JavaScript Window History81. JavaScript Window Navigator82. JavaScript Popup Boxes83. JavaScript Timing Events84. JavaScript Cookies85. Web APIs - Introduction86. JavaScript Fetch API87. Web Geolocation API88. Web History API89. Pointer Events API90. Web Storage API91. JavaScript Validation API92. Web Workers API93. AJAX Introduction94. AJAX - The XMLHttpRequest Object95. AJAX - XMLHttpRequest96. AJAX - Server Response97. AJAX XML Example98. AJAX PHP Example99. AJAX ASP Example100. AJAX Database Example101. XML Applications102. JavaScript JSON103. JSON Syntax104. JSON vs XML105. JSON Data Types106. JSON.parse()107. JSON.stringify()108. JSON Object Literals109. JSON Array Literals110. JSON PHP111. JSON HTML112. JSONP113. JavaScript / jQuery DOM Selectors114. JavaScript / jQuery HTML Elements115. JavaScript / jQuery CSS Styles116. JavaScript / jQuery HTML DOM117. JavaScript Graphics118. HTML Canvas119. Plotly.js120. Chart.js121. Google Chart122. D3.js123. JavaScript Interview Preparation

On this page

The Export KeywordNamed ExportsModule File "person.js"Name StrictnessToolbox Utilities (Helpers)Tree-ShakingWhen to Use Named Export?Default ExportsDefault is FlexibleDefault is CleanCombining Default + NamedModule FileModule ScriptWhen to Use Default Export?