База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

import — импортиране на JavaScript модули

Ключовата дума import предоставя достъп до експорти от други модули. Научете за статичните декларации и живите връзки, както и за разликите между import(...), import.meta и обикновените извиквания на функции.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

import е запазена ключова дума и не може да бъде име на променлива. Статична декларация import се появява само на най-горното ниво на модул, а не във функция или блок. Спецификаторът на модула трябва да е низов литерал. Статичните импортирания са част от модулната система, въведена в ECMAScript 2015.

Импортирането по подразбиране избира експорта default; именуваното импортиране избира конкретен експорт, а as му задава локално име. Формата import * as namespace създава локална връзка към обекта на пространството от имена на модула. import "module" изпълнява зависимостта, без да създава локални връзки. Импортираните връзки са живи: те отразяват промените в модула, който експортира. Импортиращият модул не може да им присвои нова стойност; това обаче не означава, че импортираният обект е замразен.

import(specifier) е отделен синтаксис за динамично импортиране, въведен в ECMAScript 2020, а не обикновена функция. Може да се използва в изрази, включително в обикновен скрипт, и връща Promise. След успешно зареждане и оценяване на модула обещанието обикновено се изпълнява с обекта на пространството от имена на модула като резултат. Ако обаче модулът експортира под името then стойност, която може да се извика, механизмът за разрешаване на обещанието я извиква. Така обещанието може да се изпълни с друга стойност или да бъде отхвърлено, въпреки че оценяването на модула е било успешно. import.meta, също от ECMAScript 2020, разкрива метаданни на модула, зависещи от хост средата, и е разрешен само в модули.

Разрешаването на спецификаторите и зареждането на модулите зависят от хост средата. Нито спецификацията на езика сама по себе си, нито успешно изпълнение в Node.js доказват поддръжка в конкретен браузър. Примерът показва жива връзка: извикването на increase() променя стойността, наблюдавана чрез count.

Примери

// 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);

Резултат

1
2

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници