fix: avoid override user defined fetch function

.changeset/yummy-tables-marry.md

@@ -0,0 +1,11 @@
+---
+"@lynx-js/runtime-wrapper-webpack-plugin": patch
+---
+
+Avoid override user defined fetch function, specify `injectGlobalFetch: false` to `pluginReactLynx` to disable global injection of `fetch` function.
+
+```js
+pluginReactLynx({
+  injectGlobalFetch: false,
+}),
+```

packages/rspeedy/plugin-react/etc/react-rsbuild-plugin.api.md

@@ -37,6 +37,7 @@ export interface PluginReactLynxOptions {
     // @alpha
     experimental_isLazyBundle?: boolean;
     firstScreenSyncTiming?: 'immediately' | 'jsReady';
+    injectGlobalFetch?: boolean;
     jsx?: Partial<JsxTransformerConfig> | undefined;
     pipelineSchedulerConfig?: number;
     removeDescendantSelectorScope?: boolean;

packages/rspeedy/plugin-react/src/entry.ts

@@ -53,6 +53,7 @@ export function applyEntry(
     pipelineSchedulerConfig,
     removeDescendantSelectorScope,
     targetSdkVersion,
+    injectGlobalFetch,
 
     experimental_isLazyBundle,
   } = options
@@ -199,6 +200,7 @@ export function applyEntry(
           targetSdkVersion,
           // Inject runtime wrapper for all `.js` but not `main-thread.js` and `main-thread.[hash].js`.
           test: /^(?!.*main-thread(?:\.[A-Fa-f0-9]*)?\.js$).*\.js$/,
+          injectGlobalFetch,
         }])
         .end()
         .plugin(`${LynxEncodePlugin.name}`)

packages/rspeedy/plugin-react/src/pluginReactLynx.ts

@@ -285,6 +285,11 @@ export interface PluginReactLynxOptions {
    * @deprecated `targetSdkVersion` is now an alias of {@link PluginReactLynxOptions.engineVersion}. Use {@link PluginReactLynxOptions.engineVersion} instead.
    */
   targetSdkVersion?: string
+  /**
+   * Inject `lynx.fetch` to global scope `fetch`.
+   * @defaultValue true
+   */
+  injectGlobalFetch?: boolean
 
   /**
    * Generate standalone lazy bundle.
@@ -341,6 +346,8 @@ export function pluginReactLynx(
     engineVersion: '',
 
     experimental_isLazyBundle: false,
+
+    injectGlobalFetch: true,
   }
   const resolvedOptions = Object.assign(defaultOptions, userOptions, {
     // Use `engineVersion` to override the default values

packages/webpack/runtime-wrapper-webpack-plugin/etc/runtime-wrapper-webpack-plugin.api.md

@@ -3,21 +3,25 @@
 > Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
 
 ```ts
+
 import type { BannerPlugin } from 'webpack';
 import type { Compiler } from 'webpack';
 
 // @public
 export class RuntimeWrapperWebpackPlugin {
-  constructor(options?: Partial<RuntimeWrapperWebpackPluginOptions>);
-  apply(compiler: Compiler): void;
-  static defaultOptions: Readonly<Required<RuntimeWrapperWebpackPluginOptions>>;
+    constructor(options?: Partial<RuntimeWrapperWebpackPluginOptions>);
+    apply(compiler: Compiler): void;
+    static defaultOptions: Readonly<Required<RuntimeWrapperWebpackPluginOptions>>;
 }
 
 // @public
 export interface RuntimeWrapperWebpackPluginOptions {
-  bannerType: (filename: string) => 'script' | 'bundle';
-  injectVars?: ((vars: string[]) => string[]) | string[];
-  targetSdkVersion: string;
-  test: BannerPlugin['options']['test'];
+    bannerType: (filename: string) => 'script' | 'bundle';
+    // Warning: (tsdoc-undefined-tag) The TSDoc tag "@default" is not defined in this configuration
+    injectGlobalFetch?: boolean;
+    injectVars?: ((vars: string[]) => string[]) | string[];
+    targetSdkVersion: string;
+    test: BannerPlugin['options']['test'];
 }
+
 ```

packages/webpack/runtime-wrapper-webpack-plugin/src/RuntimeWrapperWebpackPlugin.ts

@@ -37,6 +37,11 @@
    * The variables to be injected into the chunk.
    */
   injectVars?: ((vars: string[]) => string[]) | string[];
+  /**
+   * Inject `lynx.fetch` to global scope `fetch`.
+   * @defaultValue true
+   */
+  injectGlobalFetch?: boolean;
 }
 
 const defaultInjectVars = [
@@ -78,6 +83,7 @@
     test: /\.js$/,
     bannerType: () => 'script',
     injectVars: defaultInjectVars,
+    injectGlobalFetch: true,
   });
 
   /**
@@ -108,7 +114,7 @@
     public compiler: Compiler,
     public options: RuntimeWrapperWebpackPluginOptions,
   ) {
-    const { targetSdkVersion, test } = options;
+    const { targetSdkVersion, test, injectGlobalFetch = true } = options;
     const { BannerPlugin } = compiler.webpack;
 
     const isDev = process.env['NODE_ENV'] === 'development'
@@ -136,6 +142,7 @@
             overrideRuntimePromise: true,
             moduleId: '[name].js',
             targetSdkVersion,
+            injectGlobalFetch,
           })
           + (isDev
             ? lynxChunkEntries(JSON.stringify(chunk.id))
@@ -216,11 +223,13 @@
   moduleId,
   overrideRuntimePromise,
   targetSdkVersion,
+  injectGlobalFetch,
 }: {
   injectStr: string;
   moduleId: string;
   overrideRuntimePromise: boolean;
   targetSdkVersion: string;
+  injectGlobalFetch?: boolean;
 }) => {
   return (
     `
@@ -230,7 +239,11 @@
       JSON.stringify(targetSdkVersion)
     };
 ${overrideRuntimePromise ? `var Promise = lynx.Promise;` : ''}
-var fetch = lynx.fetch;
+${
+      injectGlobalFetch
+        ? `var fetch = lynx.fetch;`
+        : ''
+    }
 `
   );
 };