Skip to content

Commit 6262a1b

Browse files
authored
docs(rolldown): add withFilter + performance chapter (#733) (#1055)
Co-authored-by: Rush Ali <s0aPii.ra@googlemail.com> closes #733 #1055
1 parent cd5f218 commit 6262a1b

File tree

1 file changed

+28
-1
lines changed

1 file changed

+28
-1
lines changed

docs/guide/rolldown.md

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -98,12 +98,39 @@ Rolldown wirft einen Fehler, wenn unbekannte oder ungültige Optionen angegeben
9898
9999
Wenn Sie die Optione nicht selbst angeben, muss der Fehler durch das verwendete Framework behoben werden. Sie können den Fehler unterdrücken, in dem Sie die Umgebungsvariable `ROLLDOWN_OPTIONS_VALIDATION=loose` setzen.
100100

101-
## Aktivieren nativer Plugins
101+
## Performanz
102+
103+
`rolldown-vite` konzentriert sich darauf, die Kompatibilität mit dem bestehenden Ökosystem sicherzustellen, daher sind die Standardeinstellungen auf einen reibungslosen Übergang ausgerichtet. Sie können die Performanz weiter erhöhen, in dem Sie auf Rust-basierte interne Plugins und andere Anpassungen umsteigen.
104+
105+
### Aktivieren nativer Plugins
102106

103107
Dank Rolldown und Oxc wurden verschiedene interne Vite-Plugins, wie beispielsweise das Alias- oder Resolve-Plugin, nach Rust portiert. Zum Zeitpunkt der Erstellung dieses Artikels ist die Verwendung dieser Plugins standardmäßig nicht aktiviert, da ihr Verhalten von den JavaScript-Versionen abweichen kann.
104108

105109
Um sie zu testen, können Sie die `experimental.enableNativePlugin`-Option in Ihrer Vite-Konfiguration auf `true` setzen.
106110

111+
### `withFilter` Wrapper
112+
113+
Plugin-Authoren haben die Möglichkeit, die [Hook-Filter-Funktion](#hook-filter-feature) zu verwenden, um den Kommunikationsaufwand zwischen Rust- und JavaScript-Laufzeiten zu verringern.
114+
Für den Fall, dass manche der genutzten Plugins diese Funktion (noch) nicht verwenden, können Sie den `withFilter`-Wrapper verwenden, um einen Filter auf das Plugin anzuwenden.
115+
116+
```js
117+
// In Ihrer vite.config.ts
118+
import { withFilter, defineConfig } from 'vite'
119+
import svgr from 'vite-plugin-svgr'
120+
121+
export default defineConfig({
122+
plugins: [
123+
// Lädt das `svgr` Plugin nur für Dateien, die mit `.svg?react` enden
124+
withFilter(
125+
svgr({
126+
/*...*/
127+
}),
128+
{ load: { id: /\.svg?react$/ } },
129+
),
130+
],
131+
})
132+
```
133+
107134
## Probleme melden
108135

109136
Da es sich um eine experimentelle Integration handelt, können Probleme auftreten. Wenn dies der Fall ist, melden Sie diese bitte im Repository [`vitejs/rolldown-vite`](https://github.com/vitejs/rolldown-vite) und **nicht im Haupt-Repository von Vite**.

0 commit comments

Comments
 (0)