LU04b - Statische Code Analyse
Hilfsmittel der IDE
WebStorm ist eine integrierte Entwicklungsumgebung (IDE) von JetBrains, die speziell für Webentwickler entwickelt wurde. Sie bietet eine Reihe von Funktionen, um Ihnen zu helfen, einen konsistenten und sauberen Code-Stil einzuhalten:
Automatische Formatierung
WebStorm kann Ihren Code automatisch formatieren, um die Einrückung, Abstände und Zeilenumbrüche gemäss den konfigurierten Code-Style-Regeln anzupassen. Sie können die automatische Formatierung verwenden, indem Sie Strg + Alt + L (Windows/Linux) oder Cmd + Alt + L (Mac) drücken.
Code-Style-Konfiguration
WebStorm ermöglicht Ihnen, benutzerdefinierte Code-Style-Regeln für verschiedene Sprachen wie HTML, CSS und JavaScript einzustellen.
Sie finden die Einstellungen unter File > Settings > Editor > Code Style
.
Sie können die Regeln für Einrückung, Leerzeichen, Umbrüche und Leerzeilen anpassen.
Linters und Code-Analyse-Tools
WebStorm unterstützt die Integration von Lintern wie z.B TSLint. Diese Tools können Ihnen dabei helfen, Ihren Code-Stil zu überprüfen und sicherzustellen, dass er den festgelegten Standards entspricht.
Live-Vorlagen und Code-Snippets
Sie können Live-Vorlagen und Code-Snippets verwenden, um häufig verwendete Codeblöcke schnell und konsistent einzufügen. Sie können eigene Vorlagen erstellen oder die von WebStorm bereitgestellten Vorlagen verwenden.
Datei- und Code-Vorlagen
WebStorm bietet Datei- und Code-Vorlagen, die als Ausgangspunkt für neue Dateien dienen und den vom Projekt vorgegebenen Stil beibehalten.
Sie können unter File > Settings > Editor > File and Code Templates
angepasst und verwaltet werden.
Code-Inspektionen
WebStorm führt Code-Inspektionen durch, um mögliche Probleme und Inkonsistenzen im Code-Stil zu erkennen. Die IDE hebt problematische Bereiche hervor und bietet schnelle Lösungen, um den Code-Stil zu verbessern.
Echtzeit-Feedback
WebStorm bietet Echtzeit-Feedback zu Ihrem Code-Stil, während Sie tippen. Die IDE kann Ihnen dabei helfen, sofortige Korrekturen vorzunehmen und so einen konsistenten Stil beizubehalten.
Indem Sie diese Funktionen von WebStorm nutzen, können Sie sicherstellen, dass Ihr Code konsistent, sauber und in Übereinstimmung mit den gewünschten Code-Style-Regeln ist.
Linter für HTML installieren
Ein Linter ist ein Programm, das den Quellcode analysiert und auf Probleme, Inkonsistenzen, Verstösse gegen Best Practices oder Stilrichtlinien hinweist. Linter helfen Entwicklern, potenzielle Fehler, Stilprobleme und schlechte Praktiken in ihrem Code frühzeitig zu erkennen, bevor sie zu Problemen führen. Sie unterstützen dabei, sauberen und konsistenten Code zu schreiben und die Codequalität insgesamt zu verbessern. Wenn Sie Ihren Code auf Github pushen, wird dieser durch htmlhint einer statischen Code-Analyse unterzogen. Damit Sie diese auch bereits auf ihrem Notebook machen können installieren Sie htmlhint auf ihrem Notebook.
Installation
HTMLHint ist ein Linter für HTML-Code, der auf Node.js basiert. Er hilft Ihnen, sicherzustellen, dass Ihr HTML-Code konsistent und gut formatiert ist. Um HTMLHint auf einem Windows-System zu installieren, führen Sie die folgenden Schritte aus:
- Stellen Sie sicher, dass Node.js auf Ihrem System installiert ist. Falls Node.js noch nicht auf Ihrem Computer installiert ist, können Sie es von der offiziellen Website (https://nodejs.org/) herunterladen und installieren. Wählen Sie die empfohlene LTS-Version (Long Term Support) für maximale Stabilität.
- Öffnen Sie die Windows-Eingabeaufforderung (CMD) oder PowerShell als Administrator.
- Installieren Sie HTMLHint global, indem Sie den folgenden Befehl eingeben:
npm install -g htmlhint
- Nach der Installation können Sie HTMLHint verwenden, um Ihre HTML-Dateien zu überprüfen. Um beispielsweise eine Datei namens index.html zu überprüfen, navigieren Sie zum Verzeichnis, in dem sich die Datei befindet, und führen Sie den folgenden Befehl aus:
htmlhint index.html
HTMLHint wird die Datei analysieren und Probleme oder Verstösse gegen die Standardregeln melden.
Sie können die Regeln anpassen, indem Sie eine Konfigurationsdatei namens .htmlhintrc
in Ihrem Projektverzeichnis erstellen und die gewünschten Regeln darin festlegen.
Um Ihre Konfiguration zu verwenden, führen Sie diesen Befehl aus:
htmlhint --config .\.github\linters\.htmlhintrc index.html
Natürlich müssen Sie den Namen der zu prüfenden Datei (hier index.html
) anpassen.
Um alle HTML-Dateien im aktuellen Projekt zu prüfen, verwenden Sie:
htmlhint --config .\.github\linters\.htmlhintrc *.html
Informationen zu den verfügbaren Regeln und ihrer Konfiguration finden Sie in der HTMLHint-Dokumentation (https://htmlhint.com/docs/user-guide/list-rules).
Webstorm Konfigurieren
Starten Sie Webstorm neu, nachdem Sie NodeJS
und htmlhint
installiert haben.
Sie müssen Webstorm die Benutzung von Powershell erlauben. Fügen Sie dazu die Anweisung ins Terminal von Webstorm ein und führen sie die Anweisung aus.
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted -Force
Benutzen
Öffnen Sie die das Terminal in Webstorm.
Dieses Terminal öffnet sich automatisch im Workspace-Ordner.
Tippen Sie nun htmlhint –config .\.github\linters\.htmlhintrc
ins Terminal-Fenster und hmtlhint wird ihren Code statisch analysieren und ihnen einen Bericht liefern.
Da wir eine an die BZZ-Standards angepasste htmlhint-Config verwenden müssen wir den Pfad zur Config immer angeben.
Windows: htmlhint –config .\.github\linters\.htmlhintrc
Unix: htmlhint –config ./.github/linters/.htmlhintrc
Passen Sie nun den Code an, bis ihr Code keine Fehler mehr enthält.