Überprüfen Sie die ES-Version von JavaScript-Dateien mit einer angegebenen ES-Version 🏆
ES Check überprüft JavaScript-Dateien mit einem Shell-Befehl auf eine bestimmte Version von ECMAScript (ES). Wenn die ES-Version einer angegebenen Datei nicht mit dem im Befehl ES Check übergebenen Argument ES version übereinstimmt, gibt ES Check einen Fehler aus und protokolliert die Dateien, die nicht mit der Prüfung übereinstimmen.
In einer modularen und gebündelten Welt ist es wichtig sicherzustellen, dass JavaScript-Dateien die Prüfung bestehen können. Lesen Sie mehr darüber, warum.
Erste Schritte Warum ES Check? Verwendung API-Debugging mitwirkende Probleme
Erste Schritte
Installieren
npm i es-check --save-dev # locallynpm i es-check -g # or globally
Überprüfen Sie, ob ein Array oder Glob von Dateien mit einer bestimmten ES-Version übereinstimmt.
- Hinweis: Fügt Anführungszeichen um Globs hinzu. Globs sind Muster wie so,
<something>/*.js.
es-check es5 './vendor/js/*.js' './dist/**/*.js'
- Das ES-Prüfskript (oben) überprüft
/dist/*.js-Dateien, um festzustellen, ob es sich um ES5 handelt. Es wirft einen Fehler aus und protokolliert Dateien, die die Prüfung nicht bestehen.
Warum ES überprüfen?
In modernen JavaScript-Builds werden Dateien gebündelt, damit sie in den Browsern optimiert bereitgestellt werden können. Entwickler gehen davon aus, dass zukünftiges JavaScript—ähnliches ES8 von einem Tool wie Babel entsprechend transpiliert (von zukünftigem JavaScript in aktuelles JavaScript geändert) wird. Manchmal gibt es ein Problem, bei dem Dateien nicht transpiliert werden. Es gab keine effiziente Möglichkeit, auf Dateien zu testen, die nicht transpiliert wurden — bis jetzt. Das macht ES Check.
Gehen Sie durch
Die folgenden Bilder zeigen Befehlszeilenskripte und die entsprechenden protokollierten Ergebnisse.
Pass
Fail
Die ES-Prüfung wird oben mit Knotenbefehlen ausgeführt. Es kann auch in npm-Skripten, CI-Tools oder Testsuiten ausgeführt werden.
API
ES Check liefert die Notwendigkeiten. Es akzeptiert seinen Platz als JavaScript-Matcher / Tester.
Allgemeine Informationen
# USAGEindex.js es-check <ecmaVersion>
Argumente
<ecmaVersion> 'define the ECMAScript version to check for against a glob of JavaScript files' required 'a glob of files to test the ECMAScript version against' required
Optionen
Module Flag
--module use ES modules, default false
Hash-Bang zulassen
--allow-hash-bang supports files that start with hash bang, default false
Nicht
--not=folderName1,folderName2 An array of file/folder names or globs that you would like to ignore. Defaults to ``.
Globale Optionen
-h, --help Display help-V, --version Display version--no-color Disable colors--quiet Quiet mode - only displays warn and error messages-v, --verbose Verbose mode - will also output debug messages
Verwendung
ES Check ist ein Shell-Befehl CLI. Es wird in Shell-Tools wie Terminal, ITerm oder Hyper ausgeführt. Es werden zwei Argumente akzeptiert: eine ECMAScript-Version (<ECMAScript version> ) und Dateien () in Globs.
Hier sind einige Beispiele für eset-Skripte, die ausgeführt werden könnten:
# globses-check ./js/*.js# array of argumentses-check ./js/*.js ./dist/*.js
Konfiguration
Wenn Sie eine konsistente Konfiguration verwenden, können Sie eine .escheckrc -Datei im JSON-Format mit den Argumenten ecmaVersion und files erstellen, sodass Sie es-check bequem eigenständig über die Befehlszeile ausführen können.
Hier ist ein Beispiel, wie eine .escheckrc -Datei aussehen wird:
{ "ecmaVersion": "es6", "module": false, "files": "./dist/**/*.js", "not": }
⚠️ HINWEIS: Wenn Sie Befehlszeilenargumente verwenden, während sich eine .escheckrc -Datei im Projektverzeichnis befindet, werden die Konfigurationswerte in .escheckrc überschrieben.
Debugging
Ab ES-Check Version 2.0.2, eine bessere fehlersuche interface ist zur verfügung gestellt. Wenn eine Datei fehlerhaft ist, wird ein Fehlerobjekt mit protokolliert:
- die fehlerhafte Datei
- der Fehler
- der Fehlerstapel
⚠️ HINWEIS: Fehlerprotokolle stammen vom Acorn-Parser, während JavaScript analysiert wird, das sich auf bestimmte Versionen von ECMAScript bezieht. Dies bedeutet, dass Fehlermeldungen nicht spezifisch für die ECMAScript-Version sind. Es bietet immer noch Kontext in Parsing-Probleme!
Danksagungen
ES Check ist ein kleines Dienstprogramm mit leistungsstarken Tools, die Isaac Z. Schlueter, Marijn Haverbeke und Matthias Etienne erstellt haben. ES Checker von Ruan YiFeng überprüft zur Laufzeit die in einem Browser unterstützte JavaScript-Version. ES Check bietet ein ähnliches Feedback wie ES Checker, jedoch zur Erstellungszeit und ist spezifisch für das Produkt, das es verwendet. ES Check wurde gestartet, nachdem ich diesen Beitrag von Philip Walton gelesen hatte.
ESET hat 3 Hauptabhängigkeiten: acorn, Glob und caporal. Um einen Beitrag zu leisten, reichen Sie ein Problem ein oder senden Sie eine Pull-Anforderung.
Mitwirkende
- Jeff Wainwright
- Brian Gonzalez
- Jon Ong
- Suhas Karanth
- Ben Junya
- Jeff Barczewski
- Brandon Casey
