feat(experimental): add fetchable environment interface

eslint.config.js

@@ -63,7 +63,13 @@ export default tseslint.config(
       'n/no-exports-assign': 'error',
       'n/no-unpublished-bin': 'error',
       'n/no-unsupported-features/es-builtins': 'error',
-      'n/no-unsupported-features/node-builtins': 'error',
+      'n/no-unsupported-features/node-builtins': [
+        'error',
+        {
+          // TODO: remove this when we don't support Node 18 anymore
+          ignores: ['Response', 'Request', 'fetch'],
+        },
+      ],
       'n/process-exit-as-throw': 'error',
       'n/hashbang': 'error',
 

packages/vite/index.cjs

@@ -48,6 +48,8 @@ const disallowedVariables = [
   'createServerModuleRunner',
   'createServerModuleRunnerTransport',
   'isRunnableDevEnvironment',
+  'createFetchableDevEnvironment',
+  'isFetchableDevEnvironment',
 ]
 disallowedVariables.forEach((name) => {
   Object.defineProperty(module.exports, name, {

packages/vite/src/node/index.ts

@@ -27,6 +27,12 @@ export {
   type RunnableDevEnvironment,
   type RunnableDevEnvironmentContext,
 } from './server/environments/runnableEnvironment'
+export {
+  createFetchableDevEnvironment,
+  isFetchableDevEnvironment,
+  type FetchableDevEnvironment,
+  type FetchableDevEnvironmentContext,
+} from './server/environments/fetchableEnvironments'
 export {
   DevEnvironment,
   type DevEnvironmentContext,

packages/vite/src/node/server/environments/fetchableEnvironments.ts

@@ -0,0 +1,59 @@
+import type { ResolvedConfig } from '../../config'
+import type { DevEnvironmentContext } from '../environment'
+import { DevEnvironment } from '../environment'
+import type { Environment } from '../../environment'
+
+export interface FetchableDevEnvironmentContext extends DevEnvironmentContext {
+  handleRequest(request: Request): Promise<Response> | Response
+}
+
+export function createFetchableDevEnvironment(
+  name: string,
+  config: ResolvedConfig,
+  context: FetchableDevEnvironmentContext,
+): FetchableDevEnvironment {
+  if (typeof Request === 'undefined' || typeof Response === 'undefined') {
+    throw new TypeError(
+      'FetchableDevEnvironment requires a global `Request` and `Response` object.',
+    )
+  }
+
+  if (!context.handleRequest) {
+    throw new TypeError(
+      'FetchableDevEnvironment requires a `handleRequest` method during initialisation.',
+    )
+  }
+
+  return new FetchableDevEnvironment(name, config, context)
+}
+
+export function isFetchableDevEnvironment(
+  environment: Environment,
+): environment is FetchableDevEnvironment {
+  return environment instanceof FetchableDevEnvironment
+}
+
+class FetchableDevEnvironment extends DevEnvironment {
+  private _handleRequest: (request: Request) => Promise<Response> | Response
+
+  constructor(
+    name: string,
+    config: ResolvedConfig,
+    context: FetchableDevEnvironmentContext,
+  ) {
+    super(name, config, context as DevEnvironmentContext)
+    this._handleRequest = context.handleRequest
+  }
+
+  public async dispatchFetch(request: Request): Promise<Response> {
+    const response = await this._handleRequest(request)
+    if (!(response instanceof Response)) {
+      throw new TypeError(
+        'FetchableDevEnvironment `context.handleRequest` must return a `Response` object.',
+      )
+    }
+    return response
+  }
+}
+
+export type { FetchableDevEnvironment }