feat: stabilize SubresourceIntegrityPlugin (#12483)

LingyuCoder · Copilot · web-flow · commit aaf1c4907ff5 · 2025-12-17T14:32:46.000+08:00
* feat: stabilize SubresourceIntegrityPlugin API

* Update website/docs/en/plugins/rspack/subresource-integrity-plugin.mdx

Co-authored-by: Copilot &lt;175728472+Copilot@users.noreply.github.com&gt;

* Update website/docs/zh/plugins/rspack/subresource-integrity-plugin.mdx

Co-authored-by: Copilot &lt;175728472+Copilot@users.noreply.github.com&gt;

* fix clippy

---------

Co-authored-by: Copilot &lt;175728472+Copilot@users.noreply.github.com&gt;
diff --git a/packages/rspack/etc/core.api.md b/packages/rspack/etc/core.api.md
@@ -2465,7 +2465,7 @@ interface Experiments_2 {
     RslibPlugin: typeof RslibPlugin;
     // (undocumented)
     RstestPlugin: typeof RstestPlugin;
-    // (undocumented)
+    // @deprecated (undocumented)
     SubresourceIntegrityPlugin: typeof SubresourceIntegrityPlugin;
     // (undocumented)
     swc: {
@@ -6612,6 +6612,7 @@ declare namespace rspackExports {
         LoaderTargetPlugin,
         OutputFileSystem,
         WatchFileSystem,
+        SubresourceIntegrityPlugin,
         web,
         lazyCompilationMiddleware,
         node,
@@ -7799,7 +7800,7 @@ type StringOrBufferCallback = (err: NodeJS.ErrnoException | null, data?: string
 type SubresourceIntegrityHashFunction = "sha256" | "sha384" | "sha512";
 
 // @public (undocumented)
-class SubresourceIntegrityPlugin extends NativeSubresourceIntegrityPlugin {
+export class SubresourceIntegrityPlugin extends NativeSubresourceIntegrityPlugin {
     constructor(options?: SubresourceIntegrityPluginOptions);
     // (undocumented)
     apply(compiler: Compiler): void;
diff --git a/packages/rspack/src/exports.ts b/packages/rspack/src/exports.ts
@@ -139,6 +139,8 @@ import {
 	SubresourceIntegrityPlugin
 } from "./builtin-plugin";
 
+export { SubresourceIntegrityPlugin };
+
 interface Web {
 	FetchCompileAsyncWasmPlugin: typeof FetchCompileAsyncWasmPlugin;
 }
@@ -371,11 +373,14 @@ interface Experiments {
 		cleanup: () => Promise<void>;
 	};
 	RemoveDuplicateModulesPlugin: typeof RemoveDuplicateModulesPlugin;
+	/**
+	 * @deprecated Use `rspack.SubresourceIntegrityPlugin` instead
+	 */
+	SubresourceIntegrityPlugin: typeof SubresourceIntegrityPlugin;
 	EsmLibraryPlugin: typeof EsmLibraryPlugin;
 	RsdoctorPlugin: typeof RsdoctorPlugin;
 	RstestPlugin: typeof RstestPlugin;
 	RslibPlugin: typeof RslibPlugin;
-	SubresourceIntegrityPlugin: typeof SubresourceIntegrityPlugin;
 	/**
 	 * @deprecated Use `rspack.lazyCompilationMiddleware` instead
 	 */
@@ -412,6 +417,7 @@ export const experiments: Experiments = {
 		}
 	},
 	RemoveDuplicateModulesPlugin,
+	SubresourceIntegrityPlugin,
 	EsmLibraryPlugin,
 	/**
 	 * Note: This plugin is unstable yet
@@ -431,7 +437,6 @@ export const experiments: Experiments = {
 	 * @internal
 	 */
 	RslibPlugin,
-	SubresourceIntegrityPlugin,
 	lazyCompilationMiddleware,
 	swc: {
 		minify,
diff --git a/tests/rspack-test/configCases/sri/async-entrypoints/rspack.config.js b/tests/rspack-test/configCases/sri/async-entrypoints/rspack.config.js
@@ -11,6 +11,6 @@ module.exports = {
 	},
 	plugins: [
 		new rspack.HtmlRspackPlugin(),
-		new rspack.experiments.SubresourceIntegrityPlugin()
+		new rspack.SubresourceIntegrityPlugin()
 	]
 };
diff --git a/tests/rspack-test/configCases/sri/css-chunk-extract/rspack.config.js b/tests/rspack-test/configCases/sri/css-chunk-extract/rspack.config.js
@@ -1,4 +1,4 @@
-const { CssExtractRspackPlugin, experiments } = require("@rspack/core");
+const { CssExtractRspackPlugin, SubresourceIntegrityPlugin } = require("@rspack/core");
 const fs = require("fs");
 const path = require("path");
 
@@ -13,7 +13,7 @@ module.exports = (_, { testPath }) => ({
   },
   plugins: [
     new CssExtractRspackPlugin(),
-    new experiments.SubresourceIntegrityPlugin({
+    new SubresourceIntegrityPlugin({
       hashFuncNames: ["sha256", "sha384"],
     }),
     {
diff --git a/tests/rspack-test/configCases/sri/css-chunk-mix/rspack.config.js b/tests/rspack-test/configCases/sri/css-chunk-mix/rspack.config.js
@@ -1,4 +1,4 @@
-const { CssExtractRspackPlugin, experiments } = require("@rspack/core");
+const { CssExtractRspackPlugin, SubresourceIntegrityPlugin } = require("@rspack/core");
 const fs = require("fs");
 const path = require("path");
 
@@ -13,7 +13,7 @@ module.exports = (_, { testPath }) => ({
   },
   plugins: [
     new CssExtractRspackPlugin(),
-    new experiments.SubresourceIntegrityPlugin({
+    new SubresourceIntegrityPlugin({
       hashFuncNames: ["sha256", "sha384"],
     }),
     {
diff --git a/tests/rspack-test/configCases/sri/css-chunk/rspack.config.js b/tests/rspack-test/configCases/sri/css-chunk/rspack.config.js
@@ -1,4 +1,4 @@
-const { experiments } = require("@rspack/core");
+const { SubresourceIntegrityPlugin } = require("@rspack/core");
 const fs = require("fs");
 const path = require("path");
 
@@ -12,7 +12,7 @@ module.exports = (_, { testPath }) => ({
     css: true
   },
   plugins: [
-    new experiments.SubresourceIntegrityPlugin({
+    new SubresourceIntegrityPlugin({
       hashFuncNames: ["sha256", "sha384"],
     }),
     {
diff --git a/tests/rspack-test/configCases/sri/link-tags/rspack.config.js b/tests/rspack-test/configCases/sri/link-tags/rspack.config.js
@@ -55,7 +55,7 @@ module.exports = {
 	},
 	plugins: [
 		new rspack.HtmlRspackPlugin(),
-		new rspack.experiments.SubresourceIntegrityPlugin(),
+		new rspack.SubresourceIntegrityPlugin(),
 		new AddLinksPlugin()
 	]
 };
diff --git a/tests/rspack-test/configCases/sri/mf-splitting/rspack.config.js b/tests/rspack-test/configCases/sri/mf-splitting/rspack.config.js
@@ -1,6 +1,5 @@
 const rspack = require("@rspack/core");
-const { experiments } = rspack;
-const { SubresourceIntegrityPlugin } = experiments;
+const { SubresourceIntegrityPlugin } = rspack;
 
 const createConfig = (runtimeChunk, mfPlugin) => ({
   mode: "production",
diff --git a/tests/rspack-test/configCases/sri/mf/rspack.config.js b/tests/rspack-test/configCases/sri/mf/rspack.config.js
@@ -1,12 +1,12 @@
-const { experiments, container } = require("@rspack/core");
+const { SubresourceIntegrityPlugin, container } = require("@rspack/core");
 
 module.exports = {
 	target: "web",
 	optimization: {
 		moduleIds: "named"
 	},
 	plugins: [
-		new experiments.SubresourceIntegrityPlugin(),
+		new SubresourceIntegrityPlugin(),
 		new container.ModuleFederationPlugin({
 			name: "app",
 			filename: "remoteEntry.js",
diff --git a/tests/rspack-test/configCases/sri/only-concatenated-module/rspack.config.js b/tests/rspack-test/configCases/sri/only-concatenated-module/rspack.config.js
@@ -22,7 +22,7 @@ module.exports = {
 		moduleIds: "named",
 	},
 	plugins: [
-		new rspack.experiments.SubresourceIntegrityPlugin(),
+		new rspack.SubresourceIntegrityPlugin(),
 		{
 			apply(compiler) {
 				compiler.hooks.done.tap('TestPlugin', () => {
diff --git a/tests/rspack-test/configCases/sri/remote-src-protocol/rspack.config.js b/tests/rspack-test/configCases/sri/remote-src-protocol/rspack.config.js
@@ -1,4 +1,4 @@
-const { experiments, HtmlRspackPlugin } = require("@rspack/core");
+const { SubresourceIntegrityPlugin, HtmlRspackPlugin } = require("@rspack/core");
 const HtmlWebpackPlugin = require("html-webpack-plugin");
 const fs = require("fs");
 const path = require("path");
@@ -12,7 +12,7 @@ module.exports = (_, { testPath }) => ([{
     crossOriginLoading: "anonymous",
   },
   plugins: [
-    new experiments.SubresourceIntegrityPlugin(),
+    new SubresourceIntegrityPlugin(),
     new HtmlRspackPlugin({
       filename: "index.html",
     }),
@@ -48,7 +48,7 @@ module.exports = (_, { testPath }) => ([{
     crossOriginLoading: "anonymous",
   },
   plugins: [
-    new experiments.SubresourceIntegrityPlugin({
+    new SubresourceIntegrityPlugin({
       htmlPlugin: require.resolve("html-webpack-plugin"),
     }),
     new HtmlWebpackPlugin({
@@ -86,7 +86,7 @@ module.exports = (_, { testPath }) => ([{
     crossOriginLoading: "anonymous",
   },
   plugins: [
-    new experiments.SubresourceIntegrityPlugin(),
+    new SubresourceIntegrityPlugin(),
     new HtmlRspackPlugin({
       filename: "index2.html",
     }),
@@ -122,7 +122,7 @@ module.exports = (_, { testPath }) => ([{
     crossOriginLoading: "anonymous",
   },
   plugins: [
-    new experiments.SubresourceIntegrityPlugin({
+    new SubresourceIntegrityPlugin({
       htmlPlugin: require.resolve("html-webpack-plugin"),
     }),
     new HtmlWebpackPlugin({
diff --git a/tests/rspack-test/configCases/sri/remote-src/rspack.config.js b/tests/rspack-test/configCases/sri/remote-src/rspack.config.js
@@ -1,4 +1,4 @@
-const { experiments, HtmlRspackPlugin } = require("@rspack/core");
+const { SubresourceIntegrityPlugin, HtmlRspackPlugin } = require("@rspack/core");
 const HtmlWebpackPlugin = require("html-webpack-plugin");
 const fs = require("fs");
 const path = require("path");
@@ -10,7 +10,7 @@ module.exports = (_, { testPath }) => ([{
     crossOriginLoading: "anonymous",
   },
   plugins: [
-    new experiments.SubresourceIntegrityPlugin(),
+    new SubresourceIntegrityPlugin(),
     new HtmlRspackPlugin({
       filename: "index.html",
     }),
@@ -39,7 +39,7 @@ module.exports = (_, { testPath }) => ([{
     crossOriginLoading: "anonymous",
   },
   plugins: [
-    new experiments.SubresourceIntegrityPlugin({
+    new SubresourceIntegrityPlugin({
       htmlPlugin: require.resolve("html-webpack-plugin"),
     }),
     new HtmlWebpackPlugin({
diff --git a/tests/rspack-test/configCases/sri/runtime-requirement/rspack.config.js b/tests/rspack-test/configCases/sri/runtime-requirement/rspack.config.js
@@ -1,4 +1,4 @@
-const { experiments } = require("@rspack/core");
+const { SubresourceIntegrityPlugin } = require("@rspack/core");
 
 module.exports = {
 	mode: "production",
@@ -9,7 +9,7 @@ module.exports = {
 	output: {
 		crossOriginLoading: "anonymous"
 	},
-	plugins: [new experiments.SubresourceIntegrityPlugin()],
+	plugins: [new SubresourceIntegrityPlugin()],
 	experiments: {
 		rspackFuture: {
 			bundlerInfo: {
diff --git a/website/docs/en/plugins/rspack/subresource-integrity-plugin.mdx b/website/docs/en/plugins/rspack/subresource-integrity-plugin.mdx
@@ -4,7 +4,7 @@ import { ApiMeta } from '@components/ApiMeta.tsx';
 
 <ApiMeta specific={['Rspack']} addedVersion="1.2.4" />
 
-The `rspack.experiments.SubresourceIntegrityPlugin` is a plugin for enabling Subresource Integrity in Rspack.
+The `rspack.SubresourceIntegrityPlugin` is a plugin for enabling Subresource Integrity in Rspack.
 
 ## What is SRI
 
@@ -26,28 +26,24 @@ The plugin supports code splitting. When you use dynamic imports, the plugin wil
 
 ## Usage
 
-You can use the plugin by importing it as an experimental plugin from `@rspack/core`:
+You can use the plugin by importing it from `@rspack/core`:
 
 ```js title="rspack.config.mjs"
-import { experiments } from '@rspack/core';
-const { SubresourceIntegrityPlugin } = experiments;
+import { SubresourceIntegrityPlugin } from '@rspack/core';
 ```
 
 Or:
 
 ```js title="rspack.config.cjs"
-const {
-  experiments: { SubresourceIntegrityPlugin },
-} = require('@rspack/core');
+const { SubresourceIntegrityPlugin } = require('@rspack/core');
 ```
 
 ### Recommended Rspack configuration
 
 The [output.crossOriginLoading](/config/output#outputcrossoriginloading) option is required for SRI to work:
 
 ```js title="rspack.config.mjs"
-import { experiments } from '@rspack/core';
-const { SubresourceIntegrityPlugin } = experiments;
+import { SubresourceIntegrityPlugin } from '@rspack/core';
 
 export default {
   output: {
@@ -64,8 +60,7 @@ When the HTML plugin([`HtmlRspackPlugin`](/plugins/rspack/html-rspack-plugin.mdx
 The SubresourceIntegrityPlugin will interact with [`HtmlRspackPlugin`](/plugins/rspack/html-rspack-plugin.mdx) by default:
 
 ```js title="rspack.config.mjs"
-import { experiments, HtmlRspackPlugin } from '@rspack/core';
-const { SubresourceIntegrityPlugin } = experiments;
+import { SubresourceIntegrityPlugin, HtmlRspackPlugin } from '@rspack/core';
 
 export default {
   plugins: [new SubresourceIntegrityPlugin(), new HtmlRspackPlugin()],
@@ -76,8 +71,7 @@ If [`html-webpack-plugin`](https://github.com/jantimon/html-webpack-plugin) is u
 
 ```js title="rspack.config.mjs"
 import HtmlWebpackPlugin from 'html-webpack-plugin';
-import { experiments } from '@rspack/core';
-const { SubresourceIntegrityPlugin } = experiments;
+import { SubresourceIntegrityPlugin } from '@rspack/core';
 
 export default {
   plugins: [
diff --git a/website/docs/zh/plugins/rspack/subresource-integrity-plugin.mdx b/website/docs/zh/plugins/rspack/subresource-integrity-plugin.mdx
@@ -4,7 +4,7 @@ import { ApiMeta } from '@components/ApiMeta.tsx';
 
 <ApiMeta specific={['Rspack']} addedVersion="1.2.4" />
 
-`rspack.experiments.SubresourceIntegrityPlugin` 是一个用于在 Rspack 中启用子资源完整性的插件。
+`rspack.SubresourceIntegrityPlugin` 是一个用于在 Rspack 中启用子资源完整性的插件。
 
 ## 什么是 SRI
 
@@ -26,28 +26,24 @@ import { ApiMeta } from '@components/ApiMeta.tsx';
 
 ## 使用方法
 
-可以通过从 `@rspack/core` 中导入，目前该插件处于实验性阶段：
+可以从 `@rspack/core` 中导入：
 
 ```js title="rspack.config.mjs"
-import { experiments } from '@rspack/core';
-const { SubresourceIntegrityPlugin } = experiments;
+import { SubresourceIntegrityPlugin } from '@rspack/core';
 ```
 
 或
 
 ```js title="rspack.config.cjs"
-const {
-  experiments: { SubresourceIntegrityPlugin },
-} = require('@rspack/core');
+const { SubresourceIntegrityPlugin } = require('@rspack/core');
 ```
 
 ### 推荐的 Rspack 配置
 
 为了确保 SRI 正常工作，需要配置 [output.crossOriginLoading](/config/output#outputcrossoriginloading) 选项：
 
 ```js title="rspack.config.mjs"
-import { experiments } from '@rspack/core';
-const { SubresourceIntegrityPlugin } = experiments;
+import { SubresourceIntegrityPlugin } from '@rspack/core';
 
 export default {
   output: {
@@ -64,8 +60,7 @@ export default {
 SubresourceIntegrityPlugin 默认会与 [`HtmlRspackPlugin`](/plugins/rspack/html-rspack-plugin.mdx) 交互：
 
 ```js title="rspack.config.mjs"
-import { experiments, HtmlRspackPlugin } from '@rspack/core';
-const { SubresourceIntegrityPlugin } = experiments;
+import { SubresourceIntegrityPlugin, HtmlRspackPlugin } from '@rspack/core';
 
 export default {
   plugins: [new SubresourceIntegrityPlugin(), new HtmlRspackPlugin()],
@@ -76,8 +71,7 @@ export default {
 
 ```js title="rspack.config.mjs"
 import HtmlWebpackPlugin from 'html-webpack-plugin';
-import { experiments } from '@rspack/core';
-const { SubresourceIntegrityPlugin } = experiments;
+import { SubresourceIntegrityPlugin } from '@rspack/core';
 
 export default {
   plugins: [

Original file line number	Diff line number	Diff line change
`@@ -11,6 +11,6 @@ module.exports = {`
`11`	`11`	`},`
`12`	`12`	`plugins: [`
`13`	`13`	`new rspack.HtmlRspackPlugin(),`
`14`		`- new rspack.experiments.SubresourceIntegrityPlugin()`
	`14`	`+ new rspack.SubresourceIntegrityPlugin()`
`15`	`15`	`]`
`16`	`16`	`};`
Original file line number	Diff line number	Diff line change
`@@ -55,7 +55,7 @@ module.exports = {`
`55`	`55`	`},`
`56`	`56`	`plugins: [`
`57`	`57`	`new rspack.HtmlRspackPlugin(),`
`58`		`- new rspack.experiments.SubresourceIntegrityPlugin(),`
	`58`	`+ new rspack.SubresourceIntegrityPlugin(),`
`59`	`59`	`new AddLinksPlugin()`
`60`	`60`	`]`
`61`	`61`	`};`
Original file line number	Diff line number	Diff line change
`@@ -22,7 +22,7 @@ module.exports = {`
`22`	`22`	`moduleIds: "named",`
`23`	`23`	`},`
`24`	`24`	`plugins: [`
`25`		`- new rspack.experiments.SubresourceIntegrityPlugin(),`
	`25`	`+ new rspack.SubresourceIntegrityPlugin(),`
`26`	`26`	`{`
`27`	`27`	`apply(compiler) {`
`28`	`28`	`compiler.hooks.done.tap('TestPlugin', () => {`