Declare missing vite:preloadErrorevent on Window namespace

[MathiasWP]

Description

Vite has a vite:preloadError custom event which can be used when loading a dynamic import fails.

This event is not declared in the global namespace, so doing

window.addEventListener('vite:preloadError', (event) => {
  event.payload // Property 'payload' does not exist on type 'Event'.
})

or

//   Argument of type '(event: Event & { payload: Error; }) => void' is not assignable to parameter of type 'EventListenerOrEventListenerObject
window.addEventListener('vite:preloadError', (event: Event & { payload: Error }) => {
  event.payload 
})

will not work unless you override the event type.

Suggested solution

Declare the event in a global namespace:

declare interface VitePreloadErrorEvent extends Event {
	payload: Error;
}

declare interface Window {
	addEventListener(
		type: 'vite:preloadError',
		listener: (this: Window, ev: VitePreloadErrorEvent) => unknown,
		options?: boolean | AddEventListenerOptions
	): void;
	removeEventListener(
		type: 'vite:preloadError',
		listener: (this: Window, ev: VitePreloadErrorEvent) => unknown,
		options?: boolean | AddEventListenerOptions
	): void;
}

Alternative

Adding this declaration to my own vite.d.ts file, but it feels like something Vite should export since the library knows the exact type.

Additional context

No response

Validations

• Follow our Code of Conduct
• Read the Contributing Guidelines.
• Read the docs.
• Check that there isn't already an issue that request the same feature to avoid creating a duplicate.