KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

import — JavaScript-modules importeren

Met het sleutelwoord import worden exports uit andere modules beschikbaar. Leer over statische declaraties en live bindings, en ontdek het verschil tussen import(...), import.meta en gewone functieaanroepen.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

import defaultExport from "module";
import { namedExport, otherExport as localName } from "module";
import * as namespace from "module";
import "module";
import(specifier);
import.meta

import is een gereserveerd sleutelwoord en kan niet als variabelenaam worden gebruikt. Een statische import-declaratie mag alleen op het hoogste niveau van een module staan, niet binnen een functie of blok. De modulespecificatie moet een tekenreeksliteral zijn. Statische imports maken deel uit van het modulesysteem dat in ECMAScript 2015 is geïntroduceerd.

Een standaardimport selecteert de default-export; een benoemde import selecteert een specifieke export, en as geeft die een lokale naam. De vorm import * as namespace maakt een lokale binding met het namespace-object van de module. import "module" voert de afhankelijkheid uit zonder lokale bindings aan te maken. Geïmporteerde bindings zijn live: ze weerspiegelen wijzigingen in de exporterende module. De importerende module kan er geen nieuwe waarde aan toewijzen; dat betekent echter niet dat een geïmporteerd object bevroren is.

import(specifier) is een aparte syntaxis voor dynamische imports, geïntroduceerd in ECMAScript 2020, en geen gewone functie. Deze syntaxis kan in expressies voorkomen, ook in een normaal script, en geeft een Promise terug. Nadat de module met succes is geladen en geëvalueerd, wordt de promise normaal gesproken vervuld met het namespace-object van de module. Heeft de module echter een aanroepbare export met de naam then, dan wordt die bij het afwikkelen van de promise aangeroepen. De promise kan daardoor met een andere waarde worden vervuld of worden afgewezen, ook als de evaluatie van de module is geslaagd. import.meta, eveneens uit ECMAScript 2020, geeft hostafhankelijke metadata van de module weer en is alleen toegestaan in modules.

De resolutie van specificaties en het laden van modules zijn afhankelijk van de hostomgeving. Noch de taalspecificatie op zichzelf, noch een geslaagde uitvoering in Node.js toont aan dat een bepaalde browser dit ondersteunt. Het voorbeeld laat een live binding zien: de aanroep increase() verandert de waarde die via count wordt waargenomen.

Voorbeelden

// counter.mjs
export let count = 1;
export function increment() {
  count += 1;
}

// main.mjs
import { count, increment as increase } from "./counter.mjs";

console.log(count);
increase();
console.log(count);

Resultaat

1
2

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen