javascript - What is the "module" package.json field for? - Stack Overflow

admin管理员组

文章数量:1134248

I've seen some npm packages (vue for example) have a module field in their package.json.

But module is not included in the package.json documentation - is this a convention of some kind? Is there documentation for this somewhere?

I've seen some npm packages (vue for example) have a module field in their package.json.

But module is not included in the package.json documentation - is this a convention of some kind? Is there documentation for this somewhere?

• javascript
• npm
• package.json

Share Improve this question Follow edited Nov 4, 2021 at 10:16 mikemaccana 123k110110 gold badges425425 silver badges529529 bronze badges asked Mar 10, 2017 at 1:20 ryanveryanve 52.5k3232 gold badges105105 silver badges142142 bronze badges 1

• 2 convention for ECMAScript modules - here's a good read on the different approaches to identifying ESM's: hackernoon.com/… – hackerrdave Commented Mar 10, 2017 at 1:38

Add a comment  | 

2 Answers 2

Sorted by: Reset to default 213

Update: April 2022

The module field is not officially defined by Node.js and support is not planned. Instead, the Node.js community settled on package exports which they believe is more versatile.

For practical reasons JavaScript bundlers will continue to support the module field. The esbuild docs explain when to use module as well as related fields main and browser.

Original Answer

Is "module" an official npm property or is this a convention of some kind?

It's a proposal, but likely to be supported due to de facto usage.

Is there documentation for this somewhere?

There is, in fact, and it can be found right here and later removed here.

What's it for?

ES6 Module Interoperability in Node. Additional discussion can be found here and here. And here's a blog post from Rich Harris talking more about it.

This is used by bundler tools for ESM (ECMAScript Module) detection. The Rollup documentation says it pretty well:

If your package.json file also has a module field, ES6-aware tools like Rollup and webpack 2 will import the ES6 module version directly.

This article on Rollup 1.0 says it another way:

The main field makes sure that Node users using require will be served the UMD version. The module field is not an official npm feature but a common convention among bundlers to designate how to import an ESM version of our library.

Further discussion of pkg.module is on the Rollup Github Wiki and the webpack Docs.

本文标签： javascriptWhat is the quotmodulequot packagejson field forStack Overflow