LU04b - Statische Code Analyse

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.

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.

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:

  1. 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.
  2. Öffnen Sie die Windows-Eingabeaufforderung (CMD) oder PowerShell als Administrator.
  3. Installieren Sie HTMLHint global, indem Sie den folgenden Befehl eingeben:
    npm install -g htmlhint
  4. 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).

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

Ö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.


© Marcel Suter, Kevin Maurizi

  • modul/m293/learningunits/lu04/statischecodeanalyse.txt
  • Zuletzt geändert: 2024/05/23 12:43
  • von msuter