docs(Configuration): explain more on the condition names (#6330)

* explain more on the condition names * Update src/content/configuration/resolve.mdx Co-authored-by: Sam Chen <[email protected]> * Update resolve.mdx Co-authored-by: Sam Chen <[email protected]>
webpack · Aug 23, 2022 · 59c6cea · 59c6cea · vercel · Aug 23, 2022
1 parent 4eb09ae
commit 59c6cea
Showing 1 changed file with 46 additions and 0 deletions.
diff --git a/src/content/configuration/resolve.mdx b/src/content/configuration/resolve.mdx
@@ -193,6 +193,52 @@ module.exports = {
 };
 ```
 
+Webpack will match [export conditions](https://nodejs.org/api/packages.html#conditional-exports) that are listed within the `resolve.conditionNames` array.
+
+The key order in the `exports` field is significant. During condition matching, earlier entries have higher priority and take precedence over later entries.
+
+For example,
+
+**package.json**
+
+```json
+{
+  "name": "foo",
+  "exports": {
+    ".": {
+      "import": "./index-import.js",
+      "require": "./index-require.js",
+      "node": "./index-node.js"
+    },
+    "./bar": {
+      "node": "./bar-node.js",
+      "require": "./bar-require.js"
+    },
+    "./baz": {
+      "import": "./baz-import.js",
+      "node": "./baz-node.js"
+    }
+  }
+}
+```
+
+**webpack.config.js**
+
+```js
+module.exports = {
+  //...
+  resolve: {
+    conditionNames: ['require', 'node'],
+  },
+};
+```
+
+importing
+
+- `'foo'` will resolve to `'foo/index-require.js'`
+- `'foo/bar'` will resolve to `'foo/bar-node.js'` as the `"node"` key comes before `"require"` key in the conditional exports object.
+- `'foo/baz'` will resolve to `'foo/baz-node.js'`
+
 ### resolve.descriptionFiles
 
 `[string] = ['package.json']`