찾다
웹 프론트엔드JS 튜토리얼Node.js 및 esbuild: cjs와 esm 혼합에 주의하세요.

Node.js and esbuild: beware of mixing cjs and esm

TL;DR

esbuild를 사용하여 cjs 및 esm 진입점이 혼합된 npm 패키지에 의존하는 --platform=node로 코드를 번들링하는 경우 다음 경험 법칙을 사용하세요.

  • --bundle을 사용하는 경우 --format을 cjs로 설정하세요. 이는 최상위 대기 기능이 있는 esm 모듈을 제외한 모든 경우에 작동합니다.
    • --format=esm을 사용할 수 있지만 이와 같은 폴리필이 필요합니다.
  • --packages=external을 사용하는 경우 --format을 esm으로 설정하세요.

cjs와 esm의 차이점이 궁금하다면 Node.js: cjs, 번들러, esm의 간략한 역사를 살펴보세요.

징후

--platform=node를 사용하여 esbuild 번들 코드를 실행할 때 다음 런타임 오류 중 하나가 발생할 수 있습니다.

Error: Dynamic require of "<module_name>" is not supported
</module_name>
Error [ERR_REQUIRE_ESM]: require() of ES Module (...) from (...) not supported.
Instead change the require of (...) in (...) to a dynamic import() which is available in all CommonJS modules.

원인

다음 제한 사항 중 하나로 인해 발생합니다.

  • esbuild의 esm을 cjs로(또는 그 반대로) 변환합니다.
  • Node.js cjs/esm 상호 운용성.

분석

esbuild는 esm과 cjs 간의 변환 기능이 제한되어 있습니다. 또한 esbuild에서 지원되는 일부 시나리오는 Node.js 자체에서는 지원되지 않습니다. esbuild@0.24.0 기준으로 다음 표에 지원되는 내용이 요약되어 있습니다.

Format Scenario Supported?
cjs static import Yes
cjs dynamic import() Yes
cjs top-level await No
cjs --packages=external of esm entry point No*
esm require() of user modules** Yes***
esm require() of node:* modules No****
esm --packages=external of cjs entry point Yes

* esbuild에서는 지원되지만 Node.js에서는 지원되지 않습니다

** npm 패키지 또는 상대 경로 파일을 나타냅니다.

*** 사용자 모듈은 몇 가지 주의 사항과 함께 지원됩니다. __dirname 및 __filename은 폴리필 없이는 지원되지 않습니다.

**** node:* 모듈은 동일한 폴리필로 지원될 수 있습니다.

다음은 폴리필을 사용하지 않은 이러한 시나리오에 대한 자세한 설명입니다.


npm 패키지

다음 예제 npm 패키지를 사용합니다.

정적 가져오기

정적 임포트가 있는 esm 모듈:

Error: Dynamic require of "<module_name>" is not supported
</module_name>

동적 가져오기

비동기 함수 내에 동적 import()가 있는 esm 모듈:

Error [ERR_REQUIRE_ESM]: require() of ES Module (...) from (...) not supported.
Instead change the require of (...) in (...) to a dynamic import() which is available in all CommonJS modules.

최상위 대기

동적 import() 및 최상위 수준 wait가 있는 esm 모듈:

import { version } from "node:process";

export function getVersion() {
  return version;
}

필요하다

require() 호출이 있는 cjs 모듈:

export async function getVersion() {
  const { version } = await import("node:process");
  return version;
}

--format=cjs

다음 인수를 사용하여 esbuild를 실행합니다.

const { version } = await import("node:process");

export function getVersion() {
  return version;
}

그리고 다음 코드:

const { version } = require("node:process");

exports.getVersion = function() {
  return version;
}

정적 가져오기

잘 실행되는 다음을 생성합니다.

esbuild --bundle --format=cjs --platform=node --outfile=bundle.cjs src/main.js

동적 가져오기()

잘 실행되는 다음을 생성합니다.

import { getVersion } from "{npm-package}";

(async () => {
  // version can be `string` or `Promise<string>`
  const version = await getVersion();

  console.log(version);
})();
</string>

동적 import()가 cjs 모듈에서도 허용되기 때문에 require()로 변환되지 않는다는 점에 유의하세요.

최상위 수준 대기

다음 오류로 인해 esbuild가 실패합니다.

// node_modules/static-import/index.js
var import_node_process = require("node:process");
function getVersion() {
  return import_node_process.version;
}

// src/main.js
(async () => {
  const version2 = await getVersion();
  console.log(version2);
})();

--패키지=외부

모든 npm 패키지에서 --packages=external을 사용하면 성공합니다.

// (...esbuild auto-generated helpers...)

// node_modules/dynamic-import/index.js
async function getVersion() {
  const { version } = await import("node:process");
  return version;
}

// src/main.js
(async () => {
  const version = await getVersion();
  console.log(version);
})();

생산품:

[ERROR] Top-level await is currently not supported with the "cjs" output format

    node_modules/top-level-await/index.js:1:20:
      1 │ const { version } = await import("node:process");
        ╵                     ~~~~~

그러나 Nodes.js는 cjs 모듈이 esm 모듈을 가져오는 것을 허용하지 않기 때문에 모두 실행되지 않습니다.

esbuild --packages=external --format=cjs --platform=node --outfile=bundle.cjs src/main.js

--format=esm

이제 다음 인수를 사용하여 esbuild를 실행합니다.

var npm_package_import = require("{npm-package}");
(async () => {
  const version = await (0, npm_package_import.getVersion)();
  console.log(version);
})();

사용자 모듈의 require()

src/main.js

/(...)/bundle.cjs:1
var import_static_import = require("static-import");
                           ^

Error [ERR_REQUIRE_ESM]: require() of ES Module /(...)/node_modules/static-import/index.js from /(...)/bundle.cjs not supported.
Instead change the require of index.js in /(...)/bundle.cjs to a dynamic import() which is available in all CommonJS modules.

잘 실행되는 다음을 생성합니다.

esbuild --bundle --format=esm --platform=node --outfile=bundle.mjs src/main.js

node:* 모듈의 require()

src/main.js

const { getVersion } = require("static-import");

console.log(getVersion());

다음을 생성합니다.

// (...esbuild auto-generated helpers...)

// node_modules/static-import/index.js
var static_import_exports = {};
__export(static_import_exports, {
  getVersion: () => getVersion
});
import { version } from "node:process";
function getVersion() {
  return version;
}
var init_static_import = __esm({
  "node_modules/static-import/index.js"() {
  }
});

// src/main.js
var { getVersion: getVersion2 } = (init_static_import(), __toCommonJS(static_import_exports));
console.log(getVersion2());

그러나 실행에 실패합니다:

import { getVersion } from "require";

console.log(getVersion());

--패키지=외부

cjs 진입점이 있는 패키지를 포함하여 모든 npm 패키지에서 --packages=external을 사용하면 성공합니다. 예:

// (...esbuild auto-generated helpers...)

var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
}) : x)(function(x) {
  if (typeof require !== "undefined") return require.apply(this, arguments);
  throw Error('Dynamic require of "' + x + '" is not supported');
});

// (...esbuild auto-generated helpers...)

// node_modules/require/index.js
var require_require = __commonJS({
  "node_modules/require/index.js"(exports) {
    var { version } = __require("node:process");
    exports.getVersion = function() {
      return version;
    };
  }
});

// src/main.js
var import_require = __toESM(require_require());
console.log((0, import_require.getVersion)());

함께:

src/index.js

Error: Dynamic require of "node:process" is not supported

esm 모듈이 cjs 진입점을 사용하여 npm 패키지를 가져올 수 있기 때문에 거의 그대로 실행되는 출력을 생성합니다.

esbuild --packages=external --format=esm --platform=node --outfile=bundle.mjs src/main.js

결론

이 게시물이 현재와 미래의 esbuild 출력 문제를 해결하는 데 도움이 되기를 바랍니다. 아래에서 여러분의 생각을 알려주세요!

위 내용은 Node.js 및 esbuild: cjs와 esm 혼합에 주의하세요.의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!

성명
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.
JavaScript로 문자열 문자를 교체하십시오JavaScript로 문자열 문자를 교체하십시오Mar 11, 2025 am 12:07 AM

JavaScript 문자열 교체 방법 및 FAQ에 대한 자세한 설명 이 기사는 JavaScript에서 문자열 문자를 대체하는 두 가지 방법 인 내부 JavaScript 코드와 웹 페이지의 내부 HTML을 탐색합니다. JavaScript 코드 내부의 문자열을 교체하십시오 가장 직접적인 방법은 대체 () 메소드를 사용하는 것입니다. str = str.replace ( "find", "replace"); 이 메소드는 첫 번째 일치 만 대체합니다. 모든 경기를 교체하려면 정규 표현식을 사용하고 전역 플래그 g를 추가하십시오. str = str.replace (/fi

8 멋진 jQuery 페이지 레이아웃 플러그인8 멋진 jQuery 페이지 레이아웃 플러그인Mar 06, 2025 am 12:48 AM

손쉬운 웹 페이지 레이아웃에 대한 jQuery 활용 : 8 에센셜 플러그인 jQuery는 웹 페이지 레이아웃을 크게 단순화합니다. 이 기사는 프로세스를 간소화하는 8 개의 강력한 JQuery 플러그인을 강조합니다. 특히 수동 웹 사이트 생성에 유용합니다.

자신의 Ajax 웹 응용 프로그램을 구축하십시오자신의 Ajax 웹 응용 프로그램을 구축하십시오Mar 09, 2025 am 12:11 AM

그래서 여기 당신은 Ajax라는이 일에 대해 배울 준비가되어 있습니다. 그러나 정확히 무엇입니까? Ajax라는 용어는 역동적이고 대화식 웹 컨텐츠를 만드는 데 사용되는 느슨한 기술 그룹을 나타냅니다. 원래 Jesse J에 의해 만들어진 Ajax라는 용어

내 자신의 JavaScript 라이브러리를 어떻게 작성하고 게시합니까?내 자신의 JavaScript 라이브러리를 어떻게 작성하고 게시합니까?Mar 18, 2025 pm 03:12 PM

기사는 JavaScript 라이브러리 작성, 게시 및 유지 관리, 계획, 개발, 테스트, 문서 및 홍보 전략에 중점을 둡니다.

Ajax를 사용하여 상자 컨텐츠를 동적으로로드합니다Ajax를 사용하여 상자 컨텐츠를 동적으로로드합니다Mar 06, 2025 am 01:07 AM

이 튜토리얼은 Ajax를 통해로드 된 동적 페이지 상자를 작성하여 전체 페이지 재 장전없이 인스턴트 새로 고침을 가능하게합니다. jQuery 및 JavaScript를 활용합니다. 맞춤형 Facebook 스타일 컨텐츠 박스 로더로 생각하십시오. 주요 개념 : Ajax와 JQuery

10 JQuery Fun 및 Games 플러그인10 JQuery Fun 및 Games 플러그인Mar 08, 2025 am 12:42 AM

10 재미있는 jQuery 게임 플러그인 웹 사이트를보다 매력적으로 만들고 사용자 끈적함을 향상시킵니다! Flash는 여전히 캐주얼 웹 게임을 개발하기위한 최고의 소프트웨어이지만 JQuery는 놀라운 효과를 만들 수 있으며 Pure Action Flash 게임과 비교할 수는 없지만 경우에 따라 브라우저에서 예기치 않은 재미를 가질 수 있습니다. jQuery tic 발가락 게임 게임 프로그래밍의 "Hello World"에는 이제 jQuery 버전이 있습니다. 소스 코드 jQuery Crazy Word Composition 게임 이것은 반은 반은 게임이며, 단어의 맥락을 알지 못해 이상한 결과를 얻을 수 있습니다. 소스 코드 jQuery 광산 청소 게임

JavaScript 용 쿠키리스 세션 라이브러리를 작성하는 방법JavaScript 용 쿠키리스 세션 라이브러리를 작성하는 방법Mar 06, 2025 am 01:18 AM

이 JavaScript 라이브러리는 Window.Name 속성을 활용하여 쿠키에 의존하지 않고 세션 데이터를 관리합니다. 브라우저에 세션 변수를 저장하고 검색하기위한 강력한 솔루션을 제공합니다. 라이브러리는 세 가지 핵심 방법을 제공합니다 : 세션

jQuery 시차 자습서 - 애니메이션 헤더 배경jQuery 시차 자습서 - 애니메이션 헤더 배경Mar 08, 2025 am 12:39 AM

이 튜토리얼은 jQuery를 사용하여 매혹적인 시차 배경 효과를 만드는 방법을 보여줍니다. 우리는 멋진 시각적 깊이를 만드는 계층화 된 이미지가있는 헤더 배너를 만들 것입니다. 업데이트 된 플러그인은 jQuery 1.6.4 이상에서 작동합니다. 다운로드

See all articles

핫 AI 도구

Undresser.AI Undress

Undresser.AI Undress

사실적인 누드 사진을 만들기 위한 AI 기반 앱

AI Clothes Remover

AI Clothes Remover

사진에서 옷을 제거하는 온라인 AI 도구입니다.

Undress AI Tool

Undress AI Tool

무료로 이미지를 벗다

Clothoff.io

Clothoff.io

AI 옷 제거제

AI Hentai Generator

AI Hentai Generator

AI Hentai를 무료로 생성하십시오.

뜨거운 도구

스튜디오 13.0.1 보내기

스튜디오 13.0.1 보내기

강력한 PHP 통합 개발 환경

드림위버 CS6

드림위버 CS6

시각적 웹 개발 도구

에디트플러스 중국어 크랙 버전

에디트플러스 중국어 크랙 버전

작은 크기, 구문 강조, 코드 프롬프트 기능을 지원하지 않음

ZendStudio 13.5.1 맥

ZendStudio 13.5.1 맥

강력한 PHP 통합 개발 환경

SublimeText3 Linux 새 버전

SublimeText3 Linux 새 버전

SublimeText3 Linux 최신 버전