찾다
웹 프론트엔드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

사용자 정의 Google 검색 API 설정 자습서사용자 정의 Google 검색 API 설정 자습서Mar 04, 2025 am 01:06 AM

이 튜토리얼은 사용자 정의 Google 검색 API를 블로그 또는 웹 사이트에 통합하는 방법을 보여 주며 표준 WordPress 테마 검색 기능보다보다 세련된 검색 경험을 제공합니다. 놀랍게도 쉽습니다! 검색을 Y로 제한 할 수 있습니다

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라는 용어

' this ' 자바 스크립트로?' this ' 자바 스크립트로?Mar 04, 2025 am 01:15 AM

핵심 포인트 JavaScript에서는 일반적으로 메소드를 "소유"하는 객체를 말하지만 함수가 호출되는 방식에 따라 다릅니다. 현재 객체가 없으면 글로벌 객체를 나타냅니다. 웹 브라우저에서는 창으로 표시됩니다. 함수를 호출 할 때 이것은 전역 객체를 유지하지만 객체 생성자 또는 그 메소드를 호출 할 때는 객체의 인스턴스를 나타냅니다. call (), apply () 및 bind ()와 같은 메소드를 사용 하여이 컨텍스트를 변경할 수 있습니다. 이 방법은 주어진이 값과 매개 변수를 사용하여 함수를 호출합니다. JavaScript는 훌륭한 프로그래밍 언어입니다. 몇 년 전,이 문장은있었습니다

소스 뷰어와의 jQuery 지식을 향상시킵니다소스 뷰어와의 jQuery 지식을 향상시킵니다Mar 05, 2025 am 12:54 AM

JQuery는 훌륭한 JavaScript 프레임 워크입니다. 그러나 어떤 도서관과 마찬가지로, 때로는 진행 상황을 발견하기 위해 후드 아래로 들어가야합니다. 아마도 버그를 추적하거나 jQuery가 특정 UI를 달성하는 방법에 대해 궁금한 점이 있기 때문일 것입니다.

모바일 개발을위한 10 개의 모바일 치트 시트모바일 개발을위한 10 개의 모바일 치트 시트Mar 05, 2025 am 12:43 AM

이 게시물은 Android, BlackBerry 및 iPhone 앱 개발을위한 유용한 치트 시트, 참조 안내서, 빠른 레시피 및 코드 스 니펫을 컴파일합니다. 개발자가 없어서는 안됩니다! 터치 제스처 참조 안내서 (PDF) Desig를위한 귀중한 자원

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

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

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를 무료로 생성하십시오.

뜨거운 도구

Atom Editor Mac 버전 다운로드

Atom Editor Mac 버전 다운로드

가장 인기 있는 오픈 소스 편집기

드림위버 CS6

드림위버 CS6

시각적 웹 개발 도구

안전한 시험 브라우저

안전한 시험 브라우저

안전한 시험 브라우저는 온라인 시험을 안전하게 치르기 위한 보안 브라우저 환경입니다. 이 소프트웨어는 모든 컴퓨터를 안전한 워크스테이션으로 바꿔줍니다. 이는 모든 유틸리티에 대한 액세스를 제어하고 학생들이 승인되지 않은 리소스를 사용하는 것을 방지합니다.

맨티스BT

맨티스BT

Mantis는 제품 결함 추적을 돕기 위해 설계된 배포하기 쉬운 웹 기반 결함 추적 도구입니다. PHP, MySQL 및 웹 서버가 필요합니다. 데모 및 호스팅 서비스를 확인해 보세요.

스튜디오 13.0.1 보내기

스튜디오 13.0.1 보내기

강력한 PHP 통합 개발 환경