Zurück zum Blog

    Engineering

    SPFx: Heft ist Standard, React 18 erst in der Preview

    Welche React-Version unterstützt SPFx? Der Stand von Heft, der neuen CLI und React 18 für produktive SharePoint-Projekte.

    3. Juni 20262 Min. Lesezeit
    Marcel Haas

    Marcel Haas

    Solution Architect, CEO

    marcel.haas@cnext.ch
    CNEXT Desk Setup
    In diesem Artikel

    Stand: September 2026. Beim SharePoint Framework (SPFx) müssen Teams zwei Änderungen auseinanderhalten: Die Heft-Toolchain ist für neue Projekte bereits Standard. React 18 ist dagegen erst in SPFx 1.24 Preview verfügbar. Wer eine produktive Lösung pflegt, sollte die React-Version nicht auf Verdacht anheben.

    React 18: erst in der Vorabversion SPFx 1.24

    Microsofts SPFx-Kompatibilitätstabelle nennt für SPFx 1.20 bis 1.23.2 weiterhin React 17.0.1. Die Versionshinweise zu SPFx 1.24 beschreiben React 18 als Funktion einer Vorabversion. Microsoft empfiehlt diese Vorabversion nicht für produktive Umgebungen.

    Das hat eine praktische Konsequenz: Ein bestehendes Web Part auf SPFx 1.20 oder 1.22 braucht keine Umstellung von ReactDOM.render() auf createRoot(). Der oft zitierte React-18-Migrationsschritt gehört erst in einen gezielten Test mit einer tatsächlich kompatiblen SPFx-Version. Prüfen Sie bei jeder Aktualisierung die exakte React-Version in Microsofts Tabelle und installieren Sie diese ohne automatische Versionssprünge. Microsoft dokumentiert dafür --save-exact.

    Heft: der Wechsel ist schon erfolgt

    SPFx 1.22 führte Heft als Standard-Build-Tool für neu erzeugte Projekte ein. Bestehende Gulp-Projekte konnten bei der Aktualisierung auf 1.22 zunächst weiter mit Gulp bauen. Microsoft beschreibt einen stufenweisen Übergang: Neue Projekte sollen Heft verwenden, während ältere Lösungen ihre eigenen Build-Anpassungen vor der Migration prüfen müssen. Webpack bleibt Teil der Toolchain.

    Für ein Team mit mehreren SPFx-Lösungen ist die richtige Reihenfolge:

    1. 1Inventar anlegen: SPFx-, Node-, React- und Toolchain-Version je Lösung erfassen.
    2. 2Sicherheits- und Wartungsstand prüfen: Die aktuelle unterstützte SPFx-Version und die Release Notes heranziehen.
    3. 3Heft getrennt testen: Ein repräsentatives Projekt mit eigenen Gulp-Aufgaben, Webpack-Anpassungen und CI-Pipeline auswählen.
    4. 4React 18 separat erproben: Nur in einer Testumgebung mit der dokumentierten SPFx-1.24-Vorschau; keine Produktionsmigration aus einer Ankündigung ableiten.

    Neue CLI: nützlich, aber versionsgebunden

    Microsoft bietet eine SPFx CLI zum Erzeugen und Bauen von Projekten an. Prüfen Sie vor dem Einsatz die unterstützten Node- und SPFx-Versionen sowie Ihre bestehenden Anpassungen, Pakete und die Deployment-Pipeline.

    Was Entwicklungsteams jetzt tun sollten

    Planen Sie die Heft-Migration nach dem tatsächlichen Projektstand. Halten Sie produktive React-Abhängigkeiten bei der von Microsoft unterstützten Version. Testen Sie React 18 isoliert, dokumentieren Sie Blocker und warten Sie auf eine produktiv unterstützte SPFx-Version, bevor Sie Kundenlösungen umstellen. Damit vermeiden Sie einen Framework-Mix, den Microsofts Kompatibilitätstabelle nicht deckt.

    SharePointMicrosoft 365Agentic EngineeringBest Practices
    Teilen:

    KI-Tools können die Erstellung dieses Artikels unterstützt haben. CNEXT verantwortet den veröffentlichten Inhalt. Produktfunktionen und Preise können sich ändern; prüfen Sie dafür die verlinkten Originalquellen.

    Marcel Haas

    Marcel Haas

    Solution Architect, CEO

    6x Microsoft Applied Skills

    SPFx-Migration mit CNEXT besprechen

    Wir erfassen mit Ihnen den Stand Ihrer SPFx-Lösungen und planen Heft- und React-Updates.