From 4d10b4e42cdcc94af607a4fa16ac06207a38cb73 Mon Sep 17 00:00:00 2001
From: neverland <chenjiahan.jait@bytedance.com>
Date: Tue, 21 Oct 2025 21:52:41 +0800
Subject: [PATCH 1/3] docs: update `output.module` for web target

---
 website/docs/en/config/output/module.mdx | 33 +++++++++++++++++++-----
 website/docs/zh/config/output/module.mdx | 33 +++++++++++++++++++-----
 2 files changed, 52 insertions(+), 14 deletions(-)

diff --git a/website/docs/en/config/output/module.mdx b/website/docs/en/config/output/module.mdx
index 9b51003f74..e07fa36896 100644
--- a/website/docs/en/config/output/module.mdx
+++ b/website/docs/en/config/output/module.mdx
@@ -7,14 +7,32 @@ Whether to output JavaScript files in ES modules format.
 
 :::tip
 
-- This feature is currently experimental and only available when [output.target](/config/output/target) is `'node'`.
+- This feature is currently experimental and only available when [output.target](/config/output/target) is `'web'` or `'node'`.
 - If you need to build JavaScript libraries in ESM format, we recommend using [Rslib](https://rslib.rs), which is an out-of-the-box library development tool built on top of Rsbuild.
 
 :::
 
-## Example
+## Web applications
 
-When building Node.js bundles, Rsbuild outputs CommonJS format by default. You can set `output.module` to `true` to output ES modules format:
+When building a web application, Rsbuild generates the output in the IIFE format by default.
+
+If you want to output ES Modules instead, set `output.module` to `true`:
+
+```ts title="rsbuild.config.ts"
+export default {
+  output: {
+    module: true,
+  },
+};
+```
+
+:::tip
+When `output.module` is enabled, Rsbuild automatically adds `type="module"` to the generated `<script>` tags, meaning [html.scriptLoading](/config/html/script-loading) is set to 'module'.
+:::
+
+## Node.js applications
+
+When building Node.js applications, Rsbuild outputs CommonJS format by default. You can set `output.module` to `true` to output ES modules format:
 
 ```ts title="rsbuild.config.ts"
 export default {
@@ -25,7 +43,7 @@ export default {
 };
 ```
 
-## Running ESM bundles
+### Running ESM bundles
 
 To properly run ESM bundles in Node.js, you can choose either of the following approaches:
 
@@ -51,6 +69,7 @@ export default {
 
 ## Version history
 
-| Version | Changes           |
-| ------- | ----------------- |
-| v1.5.0  | Added this option |
+| Version | Changes                     |
+| ------- | --------------------------- |
+| v1.5.0  | Added this option           |
+| v1.6.0  | Support for `target: 'web'` |
diff --git a/website/docs/zh/config/output/module.mdx b/website/docs/zh/config/output/module.mdx
index 47158a8bda..6694eaec44 100644
--- a/website/docs/zh/config/output/module.mdx
+++ b/website/docs/zh/config/output/module.mdx
@@ -7,14 +7,32 @@
 
 :::tip
 
-- 此功能目前为实验性功能，仅在 [output.target](/config/output/target) 为 `'node'` 时可用。
+- 此功能目前为实验性功能，仅在 [output.target](/config/output/target) 为 `'web'` 或 `'node'` 时可用。
 - 如果你需要构建 ESM 格式的 JavaScript 库，推荐使用 [Rslib](https://rslib.rs)，它是一个开箱即用的库开发工具，基于 Rsbuild 实现。
 
 :::
 
-## 示例
+## Web 应用
 
-在构建 Node.js bundles 时，Rsbuild 默认输出 CommonJS 格式的产物，你可以将 `output.module` 设置为 `true` 来输出 ES modules 格式：
+在构建 Web 应用时，Rsbuild 默认会生成 IIFE 格式的产物。
+
+如果你希望输出 ES Modules 格式，可以将 `output.module` 设置为 `true`：
+
+```ts title="rsbuild.config.ts"
+export default {
+  output: {
+    module: true,
+  },
+};
+```
+
+:::tip
+开启 `output.module` 后，Rsbuild 生成的 `<script>` 标签会自动添加 `type="module"` 属性，即 [html.scriptLoading](/config/html/script-loading) 为 `'module'`。
+:::
+
+## Node.js 应用
+
+在构建 Node.js 应用时，Rsbuild 默认输出 CommonJS 格式的产物，你可以将 `output.module` 设置为 `true` 来输出 ES modules 格式：
 
 ```ts title="rsbuild.config.ts"
 export default {
@@ -25,7 +43,7 @@ export default {
 };
 ```
 
-## 运行 ESM 产物
+### 运行 ESM 产物
 
 为了在 Node.js 中正确运行 ESM 产物，你可以选择以下任一方式：
 
@@ -51,6 +69,7 @@ export default {
 
 ## 版本历史
 
-| 版本   | 变更内容   |
-| ------ | ---------- |
-| v1.5.0 | 新增该选项 |
+| 版本   | 变更内容                      |
+| ------ | ----------------------------- |
+| v1.5.0 | 新增该选项                    |
+| v1.6.0 | 支持在 `target: 'web'` 时使用 |

From 7ed5be9b35a903c7feb89c4e9404f44575415682 Mon Sep 17 00:00:00 2001
From: neverland <chenjiahan.jait@bytedance.com>
Date: Tue, 21 Oct 2025 21:53:06 +0800
Subject: [PATCH 2/3] fix

---
 packages/core/src/plugins/esm.ts | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/core/src/plugins/esm.ts b/packages/core/src/plugins/esm.ts
index 7031b37d86..f6919857c8 100644
--- a/packages/core/src/plugins/esm.ts
+++ b/packages/core/src/plugins/esm.ts
@@ -12,10 +12,6 @@ export const pluginEsm = (): RsbuildPlugin => ({
       }
 
       if (target === 'web') {
-        api.logger.warn(
-          '[rsbuild:config] `output.module` for web target is experimental and may not work as expected.',
-        );
-
         // Temporary solution to fix the issue of runtime chunk not loaded as expected.
         chain.optimization.runtimeChunk(true);
       }

From 42f9c35470335b4f538d873a447f2efc9e248bbb Mon Sep 17 00:00:00 2001
From: neverland <chenjiahan.jait@bytedance.com>
Date: Tue, 21 Oct 2025 22:00:36 +0800
Subject: [PATCH 3/3] Update website/docs/en/config/output/module.mdx

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 website/docs/en/config/output/module.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/en/config/output/module.mdx b/website/docs/en/config/output/module.mdx
index e07fa36896..7312d62a51 100644
--- a/website/docs/en/config/output/module.mdx
+++ b/website/docs/en/config/output/module.mdx
@@ -27,7 +27,7 @@ export default {
 ```
 
 :::tip
-When `output.module` is enabled, Rsbuild automatically adds `type="module"` to the generated `<script>` tags, meaning [html.scriptLoading](/config/html/script-loading) is set to 'module'.
+When `output.module` is enabled, Rsbuild automatically adds `type="module"` to the generated `<script>` tags, meaning [html.scriptLoading](/config/html/script-loading) is set to `module`.
 :::
 
 ## Node.js applications