---
title: "PSR-14 Events"
manual: "Vite AssetCollector"
version: "main"
permalink: "https://docs.typo3.org/permalink/praetorius/vite-asset-collector:extending-events@main"
source: "Extending/Events.rst"
rendered: "2026-11-15T13:51:42+00:00"
---

# PSR-14 Events {#extending-events}

Events can be used to customize the behavior of the extension. To
attach your custom event listener to an event, check out
[Event dispatcher (PSR-14 events)](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/Events/EventDispatcher/Index.html#eventdispatcher).

## BuildViteContextEvent {#extending-events-build-vite-context}

`PraetoriusViteAssetCollectorEventBuildViteContextEvent` is
dispatched once per request by a middleware, both in frontend and in
backend context. Its listeners determine whether the Vite dev server
should be used and which dev server URI applies. The resulting
`ViteContext` object is available as [request attribute](https://docs.typo3.org/permalink/praetorius/vite-asset-collector:php-api-vite-context@main) afterwards.

The middleware runs after the site has been resolved (frontend) and after
the backend user has been authenticated (backend), so both are available
in the request object.

The extension's default listener
`praetorius/vite-asset-collector/build-vite-context` evaluates the
[extension configuration](https://docs.typo3.org/permalink/praetorius/vite-asset-collector:configuration-devserver@main). To adjust its
result, register your listener after the default listener:

**EXT:sitepackage/Classes/EventListener/ViteContextForBackendUsers.php**

```php
namespace MyVendor\Sitepackage\EventListener;

use Praetorius\ViteAssetCollector\Context\ViteContext;
use Praetorius\ViteAssetCollector\Event\BuildViteContextEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(after: 'praetorius/vite-asset-collector/build-vite-context')]
final readonly class ViteContextForBackendUsers
{
    public function __invoke(BuildViteContextEvent $event): void
    {
        $currentContext = $event->getViteContext();
        // ...
        $event->setViteContext(new ViteContext(
            useDevServer: false,
            devServer: $currentContext->devServer,
        ));
    }
}
```

Alternatively, you can register your listener before the default listener
and then stop the event's propagation with `$event->stopPropagation()`.
Note that this will prevent all following listeners from running.
