Skip to content

Commit 861f5ee

Browse files
authored
refactor: bump required node version to 20.19+, 22.12+ and remove cjs build (#781) (#1066)
Co-authored-by: Rush Ali <s0aPii.ra@googlemail.com> closes #781 #1066
1 parent c7b829f commit 861f5ee

File tree

2 files changed

+16
-32
lines changed

2 files changed

+16
-32
lines changed

docs/guide/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ Folgende Vorlagen werden unterstützt:
4444
## Scaffolding für Ihr erstes Vite Projekt
4545

4646
::: tip Kompatibilitätshinweis
47-
Vite erfordert [Node.js](https://nodejs.org/en/) Version 18+ oder 20+. Einige Vorlagen benötigen jedoch eine höhere Node.js-Version, um zu funktionieren. Bitte aktualisieren Sie diese, wenn Ihr Paketmanager Sie davor warnt.
47+
Vite erfordert [Node.js](https://nodejs.org/en/) Version 20.19+, 22.12+. Einige Vorlagen benötigen jedoch eine höhere Node.js-Version, um zu funktionieren. Bitte aktualisieren Sie diese, wenn Ihr Paketmanager Sie davor warnt.
4848
:::
4949

5050
::: code-group

docs/guide/troubleshooting.md

Lines changed: 15 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -4,37 +4,6 @@ Siehe [Rollup-Fehlerbehebungshandbuch](https://rollupjs.org/troubleshooting/) f
44

55
Wenn die hier vorgeschlagenen Lösungen nicht funktionieren, versuchen Sie, Ihre Fragen in [GitHub-Diskussionen](https://github.com/vitejs/vite/discussions) zu posten oder im `#help`-Kanal von [Vite Land Discord](https://chat.vite.dev) zu stellen.
66

7-
## CJS
8-
9-
### Vite CJS Node API veraltet
10-
11-
Die CJS-Build des Node-API von Vite ist veraltet und wird in Vite 6 entfernt. Weitere Informationen finden Sie in der [GitHub-Diskussion](https://github.com/vitejs/vite/discussions/13928). Sie sollten Ihre Dateien oder Frameworks aktualisieren, um stattdessen den ESM-Build von Vite zu importieren.
12-
13-
In einem einfachen Vite-Projekt stellen Sie sicher, dass:
14-
15-
1. Der Inhalt der Datei `vite.config.js` die ESM-Syntax verwendet.
16-
2. Die nächstgelegene `package.json`-Datei, die `"type": "module"` enthält oder die Erweiterung `.mjs`/`.mts` verwendet, z.B. `vite.config.mjs` or `vite.config.mts`.
17-
18-
Für andere Projekte gibt es einige allgemeine Ansätze:
19-
20-
- **ESM als Standard konfigurieren, bei Bedarf Opt-In für CJS:** Fügen Sie `"type": "module"` in die `package.json` des Projekts hinzu. Alle `*.js`-Dateien werden jetzt als ESM interpretiert und müssen die ESM-Syntax verwenden. Sie können eine Datei mit der Erweiterung `.cjs` umbenennen, um weiterhin CJS zu verwenden.
21-
- **Behalten Sie CJS als Standard und optieren Sie bei Bedarf für ESM:** Wenn die `package.json` des Projekts nicht `"type": "module"` enthält, werden alle `*.js`-Dateien als CJS interpretiert. Sie können eine Datei mit der Erweiterung `.mjs` umbenennen, um stattdessen ESM zu verwenden.
22-
- **Importieren Sie Vite dynamisch:** Wenn Sie CJS weiterhin verwenden müssen, können Sie Vite dynamisch mit `import('vite')` importieren. Dies erfordert, dass Ihr Code in einem `async`-Kontext geschrieben ist, sollte aber trotzdem gut beherrschbar sein, da die Vite-API größtenteils asynchron ist.
23-
24-
Wenn Sie unsicher sind, wo die Warnung herkommt, können Sie Ihr Skript mit der Flagge `VITE_CJS_TRACE=true` ausführen, um den Stapelrückverfolgung zu protokollieren:
25-
26-
```bash
27-
VITE_CJS_TRACE=true vite dev
28-
```
29-
30-
Wenn Sie die Warnung vorübergehend ignorieren möchten, können Sie Ihr Skript mit der Flagge `VITE_CJS_IGNORE_WARNING=true` ausführen:
31-
32-
```bash
33-
VITE_CJS_IGNORE_WARNING=true vite dev
34-
```
35-
36-
Beachten Sie, dass postcss-Konfigurationsdateien die ESM + TypeScript (`.mts` oder `.ts` in `„type“: „module“`) noch nicht unterstützen. Wenn Sie postcss-Konfigurationen mit `.ts` haben und `„type“: „module"` zu package.json hinzugefügt haben, müssen Sie auch die postcss-Konfiguration umbenennen, um `.cts` zu verwenden.
37-
387
## Befehlszeilenschnittstelle (CLI)
398

409
### `Fehler: Modul 'C:\foo\bar&baz\vite\bin\vite.js' nicht gefunden`
@@ -246,3 +215,18 @@ Beispiele für Verknüpfungen zwischen verschiedenen Laufwerken sind:
246215
- Ein Symlink/Junction zu einem anderen Laufwerk über den `mklink`-Befehl (z.B. Yarn Global Cache)
247216

248217
Verwandtes Problem: [#10802](https://github.com/vitejs/vite/issues/10802)
218+
219+
<script setup lang="ts">
220+
// Weiterleitung von alten Links mit Hash zu alten Dokumentations-Versionen
221+
if (typeof window !== "undefined") {
222+
const hashForOldVersion = {
223+
'vite-cjs-node-api-deprecated': 6
224+
}
225+
226+
const version = hashForOldVersion[location.hash.slice(1)]
227+
if (version) {
228+
// Aktualisieren des Schemas und des Ports, damit es in der lokalen Vorschau funktioniert (lokal mit http und 4173)
229+
location.href = `https://v${version}.vite.dev` + location.pathname + location.search + location.hash
230+
}
231+
}
232+
</script>

0 commit comments

Comments
 (0)