feat!: remove deprecated getHooks method from plugins (#12738)

LingyuCoder · web-flow · commit 3c5a3e0fb0d2 · 2026-01-15T13:14:54.000+08:00
refactor: remove deprecated getHooks method from plugins
diff --git a/packages/rspack/etc/core.api.md b/packages/rspack/etc/core.api.md
@@ -3038,7 +3038,6 @@ export type HotUpdateMainFilename = FilenameTemplate;
 
 // @public (undocumented)
 export const HtmlRspackPlugin: typeof HtmlRspackPluginImpl & {
-    getHooks: (compilation: Compilation) => HtmlRspackPluginHooks;
     getCompilationHooks: (compilation: Compilation) => HtmlRspackPluginHooks;
     createHtmlTagObject: (tagName: string, attributes?: Record<string, string | boolean>, innerHTML?: string) => JsHtmlPluginTag;
     version: number;
@@ -6413,7 +6412,6 @@ type RewriteTo = (context: HistoryContext) => string;
 
 // @public (undocumented)
 const RsdoctorPlugin: typeof RsdoctorPluginImpl & {
-    getHooks: (compilation: Compilation) => RsdoctorPluginHooks;
     getCompilationHooks: (compilation: Compilation) => RsdoctorPluginHooks;
 };
 
@@ -7169,7 +7167,6 @@ enum RuntimeModuleStage {
 
 // @public (undocumented)
 export const RuntimePlugin: typeof RuntimePluginImpl & {
-    getHooks: (compilation: Compilation) => RuntimePluginHooks;
     getCompilationHooks: (compilation: Compilation) => RuntimePluginHooks;
 };
 
diff --git a/packages/rspack/src/builtin-plugin/RsdoctorPlugin.ts b/packages/rspack/src/builtin-plugin/RsdoctorPlugin.ts
@@ -107,16 +107,10 @@ const compilationHooksMap: WeakMap<Compilation, RsdoctorPluginHooks> =
   new WeakMap();
 
 const RsdoctorPlugin = RsdoctorPluginImpl as typeof RsdoctorPluginImpl & {
-  /**
-   * @deprecated Use `getCompilationHooks` instead.
-   */
-  getHooks: (compilation: Compilation) => RsdoctorPluginHooks;
   getCompilationHooks: (compilation: Compilation) => RsdoctorPluginHooks;
 };
 
-RsdoctorPlugin.getHooks = RsdoctorPlugin.getCompilationHooks = (
-  compilation: Compilation,
-) => {
+RsdoctorPlugin.getCompilationHooks = (compilation: Compilation) => {
   checkCompilation(compilation);
 
   let hooks = compilationHooksMap.get(compilation);
diff --git a/packages/rspack/src/builtin-plugin/RuntimePlugin.ts b/packages/rspack/src/builtin-plugin/RuntimePlugin.ts
@@ -20,19 +20,13 @@ export type RuntimePluginHooks = {
 };
 
 const RuntimePlugin = RuntimePluginImpl as typeof RuntimePluginImpl & {
-  /**
-   * @deprecated Use `getCompilationHooks` instead.
-   */
-  getHooks: (compilation: Compilation) => RuntimePluginHooks;
   getCompilationHooks: (compilation: Compilation) => RuntimePluginHooks;
 };
 
 const compilationHooksMap: WeakMap<Compilation, RuntimePluginHooks> =
   new WeakMap();
 
-RuntimePlugin.getHooks = RuntimePlugin.getCompilationHooks = (
-  compilation: Compilation,
-) => {
+RuntimePlugin.getCompilationHooks = (compilation: Compilation) => {
   checkCompilation(compilation);
 
   let hooks = compilationHooksMap.get(compilation);
diff --git a/packages/rspack/src/builtin-plugin/html-plugin/plugin.ts b/packages/rspack/src/builtin-plugin/html-plugin/plugin.ts
@@ -243,10 +243,6 @@ function htmlTagObjectToString(tag: {
 }
 
 const HtmlRspackPlugin = HtmlRspackPluginImpl as typeof HtmlRspackPluginImpl & {
-  /**
-   * @deprecated Use `getCompilationHooks` instead.
-   */
-  getHooks: (compilation: Compilation) => HtmlRspackPluginHooks;
   getCompilationHooks: (compilation: Compilation) => HtmlRspackPluginHooks;
   createHtmlTagObject: (
     tagName: string,
@@ -287,8 +283,7 @@ HtmlRspackPlugin.createHtmlTagObject = (
   };
 };
 
-HtmlRspackPlugin.getHooks = HtmlRspackPlugin.getCompilationHooks =
-  getPluginHooks;
+HtmlRspackPlugin.getCompilationHooks = getPluginHooks;
 HtmlRspackPlugin.version = 5;
 
 export { HtmlRspackPlugin };
