Skip to content

Commit b8d8eb7

Browse files
authored
docs(rolldown): update to reflect the latest changes (#829) (#1101)
Co-authored-by: Rush Ali <s0aPii.ra@googlemail.com> closes #829 #1101
1 parent 891ff17 commit b8d8eb7

File tree

1 file changed

+22
-12
lines changed

1 file changed

+22
-12
lines changed

docs/guide/rolldown.md

Lines changed: 22 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -89,15 +89,15 @@ Nachdem Sie diese Überschreibungen hinzugefügt haben, installieren Sie Ihre Ab
8989

9090
Rolldown soll zwar ein direkter Ersatz für Rollup sein, es gibt jedoch Funktionen, die noch implementiert werden, sowie geringfügige beabsichtigte Unterschiede im Verhalten. Eine umfassende Liste finden Sie in [diesem GitHub PR](https://github.com/vitejs/rolldown-vite/pull/84#issue-2903144667), der regelmäßig aktualisiert wird.
9191

92-
### Fehler bei der Validierung von Optionen
92+
### Warnungen bei der Validierung von Optionen
9393

94-
Rolldown wirft einen Fehler, wenn unbekannte oder ungültige Optionen angegeben werden. Da manche Optionen, die in Rollup verfügbar sind, in Rolldown nicht zur Verfügung stehen, kann es zu Fehlern kommen. Im Folgenden sehen Sie ein Beispiel für solch eine Fehlermeldung:
94+
Rolldown erzeugt eine Warnung, wenn unbekannte oder ungültige Optionen angegeben werden. Da manche Optionen, die in Rollup verfügbar sind, in Rolldown nicht zur Verfügung stehen, kann es zu Warnungen kommen. Im Folgenden sehen Sie ein Beispiel für solch eine Warnung:
9595

96-
> Error: Failed validate input options.
96+
> Warning validate output options.
9797
>
98-
> - For the "preserveEntrySignatures". Invalid key: Expected never but received "preserveEntrySignatures".
98+
> - For the "generatedCode". Invalid key: Expected never but received "generatedCode".
9999
100-
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.
100+
Wenn Sie die Optione nicht selbst angeben, muss der Fehler durch das verwendete Framework behoben werden.
101101

102102
### API Unterschiede
103103

@@ -257,6 +257,12 @@ const plugin = {
257257
}
258258
```
259259

260+
::: tip
261+
262+
Seit Vite 7.0.0 ist `this.meta` in allen Hooks verfügbar. In früheren Versionen war `this.meta` in Vite-spezifischen Hooks nicht verfügbar, wie zum Beispiel der `config`-Hook.
263+
264+
:::
265+
260266
<br>
261267

262268
Prüfen der Existenz des `rolldownVersion` Exports:
@@ -275,17 +281,15 @@ Wenn sie `vite` als Abhängigkeit (nicht als Peer-Abhängigkeit) haben, bietet s
275281

276282
### Ignorieren der Optionsvalidierung in Rolldown
277283

278-
Wie [oben erwähnt](#option-validation-errors), wirft Rolldown einen Fehler wenn unbekannte oder ungültige Optionen übergeben werden.
284+
Wie [oben erwähnt](#option-validation-errors) erzeugt Rolldown eine Warnung, wenn unbekannte oder ungültige Optionen übergeben werden.
279285

280286
Dieser Fehler kann behoben werden, in dem die Option nur unter bestimmten Bedingungen angegeben wird. Wie [oben gezeigt](#detecting-rolldown-vite), muss dann in der Bedingung geprüft werden, ob das Programm mit rolldown-vite ausgeführt wird.
281287

282-
Das Unterdrücken der Fehlermeldung durch das Setzen der Umgebungsvariable `ROLLDOWN_OPTIONS_VALIDATION=loose` funktioniert in diesem Fall auch.
283-
284-
Beachten Sie allerdings, dass Sie irgendwann aufhören müssen, Optionen anzugeben, die nicht von Rolldown unterstützt werden.
285-
286288
### `transformWithEsbuild` benötigt eine seperate `esbuild` Installation
287289

288-
Eine ähnliche Funktion namens `transformWithOxc`, die Oxc anstelle von `esbuild` verwendet, wird von `rolldown-vite` exportiert.
290+
Da Vite selbst `esbuild` nicht mehr verwendet, wird `esbuild` als optionale Peer-Abhängigkeit behandelt. Wenn Ihr Plugin `transformWithEsbuild` verwendet, muss es `esbuild` zu seinen Abhängigkeiten hinzufügen oder der Nutzer muss es manuell installieren.
291+
292+
Die empfohlene Migration ist die Verwendung der neulich exportierten Funktion `transformWithOxc`, welche Oxc anstelle von `esbuild` verwendet.
289293

290294
### Kompatibilitätsschicht für `esbuild`-Optionen
291295

@@ -308,6 +312,12 @@ Rolldown hat eine [Hook-Filter](https://rolldown.rs/guide/plugin-development#plu
308312

309313
Dies wird auch von Rollup 4.38.0+ und Vite 6.3.0+ unterstützt. Um eine Rückwärtskompatibilität für ältere Versionen für Ihr Plugin zu gewährleisten, sollten Sie die Filter auch im Hook-Behandler ausführen.
310314

315+
::: tip
316+
317+
[`@rolldown/pluginutils`](https://www.npmjs.com/package/@rolldown/pluginutils) exportiert einige Funktionen für Hook-Filter wie `exactRegex` oder `prefixRegex`.
318+
319+
:::
320+
311321
### Inhalt zu JavaScript konvertieren in `load`- oder `transform`-Hooks
312322

313323
Wenn Sie den Inhalt von anderen Typen zu JavaScript konvertieren in `load`- oder `transform`-Hooks, müssen Sie möglicherweise `moduleType: 'js'` zur zurückgegebenen Variable hinzufügen.
@@ -327,4 +337,4 @@ const plugin = {
327337
}
328338
```
329339

330-
Das liegt daran, dass [Rolldown unterstützt JavaScript-fremde Module](https://rolldown.rs/guide/in-depth/module-types) und leitet sich den Modultyp aus der Erweiterung ab, außer es wird spezifiziert. Beachten Sie, dass `rolldown-vite` keine ModuleTypes in dev unterstützt.
340+
Das liegt daran, dass [Rolldown unterstützt JavaScript-fremde Module](https://rolldown.rs/guide/in-depth/module-types) und leitet sich den Modultyp aus der Erweiterung ab, außer es wird spezifiziert.

0 commit comments

Comments
 (0)