Import Variables from another file using JavaScript

avatar

Borislav Hadzhiev

Last updated: Jul 25, 2022

banner

Check out my new book

Import Variables from another file using JavaScript #

To import a variable from another file in JavaScript:

  1. Export the variable from file A, e.g. export const str = 'Hello world'.
  2. Import the variable in file B as import { str } from './another-file.js'.

Here is an example of exporting two variables from a file called another-file.js.

another-file.js
// 👇️ named export export const str = 'Hello world'; // 👇️ named export export const str2 = 'one two three';

Here is how we would import the variables in a file called index.js.

index.js
// 👇️ named import import {str, str2} from './another-file.js'; console.log(str); // 👉️ "Hello world" console.log(str2); // 👉️ "one two three"

Make sure to correct the path that points to the another-file.js module if you have to. The example assumes that another-file.js and index.js are located in the same directory.

For example, if another-file.js was located one directory up, you'd have to import as import {str} from '../another-file.js'.

We wrapped the name of the variable in curly braces when importing it. This is called a named import.

The syntax we're using to export and import variables is called JavaScript modules.

In order to be able to import a variable from a different file, it has to be exported using a named or a default export.

The example above uses a named export and a named import.

The main difference between named and default exports and imports is that you can have multiple named exports per file, but you can only have a single default export.

Let's look at an example of how we would import a variable that was exported using a default export.

Here are the contents of another-file.js.

another-file.js
const str = 'Hello world'; // 👇️ default export export default str;

And here is how we would import the variable using a default import.

index.js
// 👇️ default import import str from './another-file.js'; console.log(str); // 👉️ "Hello world"

Notice that we didn't wrap the import in curly braces.

We could have also used a different name when importing the variable, e.g. fooBar.

index.js
// 👇️ default import import fooBar from './another-file.js'; console.log(fooBar); // 👉️ "Hello world"

This works, but is confusing and should be avoided.

If you are exporting a variable (or an arrow function) as a default export, you have to declare it on 1 line and export it on the next. You can't declare and default export a variable on the same line.

In my experience, most real world codebases exclusively use named exports and imports, because they make it easier to leverage your IDE for autocompletion and auto-imports.
You also don't have to think about which members are exported with a default or named export.

You can also mix and match. Here is an example of a file that uses both a default and a named export.

another-file.js
const str = 'Hello world'; // 👇️ default export export default str; // 👇️ named export export const num = 100;

And here is how you would import the two variables.

index.js
// 👇️ default and named imports import str, { num } from './another-file.js'; console.log(str); // 👉️ "Hello world" console.log(num); // 👉️ 100

We used a default import to import the str variable and a named import to import the num variable.

Note that you can only have a single default export per file, but you can have as many named exports as necessary.

Use the search field on my Home Page to filter through my more than 3,000 articles.