Sprawdź pliki JavaScript w wersji ES w stosunku do określonej wersji ES 🏆
es Check sprawdza pliki JavaScript z podaną wersją ECMAScript (ES) za pomocą polecenia powłoki. Jeśli określona Wersja pliku ES nie pasuje do argumentu wersji ES przekazanego w poleceniu ES Check, ES Check wyświetli błąd i zarejestruje pliki, które nie pasowały do sprawdzenia.
zapewnienie, że pliki JavaScript mogą przejść kontrolę ES jest ważne w świecie modułowym i pakietowym. Przeczytaj więcej o tym, dlaczego.
rozpocznij dlaczego es Check? Użycie przeglądanie błędów w interfejsie API
rozpocznij
zainstaluj
npm i es-check --save-dev # locallynpm i es-check -g # or globally
sprawdź, czy tablica lub glob plików pasuje do określonej wersji ES.
- Uwaga: dodaje cytat wokół globs. Globusy to takie wzory,
<something>/*.js.
es-check es5 './vendor/js/*.js' './dist/**/*.js'
- skrypt es Check (powyżej) sprawdza pliki
/dist/*.js, aby sprawdzić, czy są to pliki ES5. Wyrzuca błąd i pliki dzienników nie przechodzą kontroli.
dlaczego warto sprawdzić?
w nowoczesnych kompilacjach JavaScript pliki są łączone, dzięki czemu mogą być obsługiwane w zoptymalizowany sposób w przeglądarkach. Deweloperzy zakładają, że przyszły JavaScript—like ES8 będzie transpilowany (zmieniony z przyszłego JavaScript na obecny JavaScript) odpowiednio przez narzędzie takie jak Babel. Czasami występuje problem, w którym pliki nie są transpilowane. Nie było skutecznego sposobu testowania plików, które nie zostały transponowane—do tej pory. To właśnie robi ES Check.
przejdź przez
poniższe obrazy przedstawiają Skrypty wiersza poleceń i odpowiadające im zarejestrowane wyniki.
Pass
Fail
es Check jest uruchamiany powyżej za pomocą komend węzła. Może być również uruchamiany w skryptach npm, narzędziach ci lub pakietach testowych.
API
ES Check zapewnia potrzeby. Akceptuje swoje miejsce jako JavaScript matcher/tester.
Informacje ogólne
# USAGEindex.js es-check <ecmaVersion>
argumenty
<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
opcje
Flaga modułów
--module use ES modules, default false
pozwól Hash Bang
--allow-hash-bang supports files that start with hash bang, default false
Nie
--not=folderName1,folderName2 An array of file/folder names or globs that you would like to ignore. Defaults to ``.
opcje globalne
-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
użycie
ES Check to polecenie powłoki CLI. Jest uruchamiany w narzędziu powłoki, takim jak Terminal, ITerm lub Hyper. Przyjmuje dwa argumenty: wersję ECMAScript (<ECMAScript version>) i pliki () w globs.
oto kilka przykładów skryptów es check, które można uruchomić:
# globses-check ./js/*.js# array of argumentses-check ./js/*.js ./dist/*.js
Konfiguracja
jeśli używasz spójnej konfiguracji, możesz utworzyć plik .escheckrc w formacie JSON z argumentami ecmaVersion i files, aby wygodnie uruchomić es-check samodzielnie z wiersza poleceń.
oto przykład jak będzie wyglądał plik .escheckrc :
{ "ecmaVersion": "es6", "module": false, "files": "./dist/**/*.js", "not": }
⚠️ Uwaga: użycie argumentów wiersza poleceń, gdy w katalogu projektu znajduje się plik .escheckrc, nadpisze wartości konfiguracyjne w .escheckrc.
debugowanie
od wersji ES-Check 2.0.2, lepszy interfejs debugowania jest dostarczany. Gdy błąd pliku, obiekt błędu zostanie zalogowany za pomocą:
- plik błędu
- błąd
- stos błędów
⚠️ Uwaga: dzienniki błędów pochodzą z parsera Acorn podczas parsowania JavaScript związanego z konkretnymi wersjami ECMAScript. Oznacza to, że komunikaty o błędach nie są specyficzne dla wersji ECMAScript. Nadal oferuje kontekst w kwestiach parsowania!
podziękowania
ES Check to małe narzędzie wykorzystujące potężne narzędzia, które zbudowali Isaac Z. Schlueter, Marijn Haverbeke i Matthias Etienne. Es Checker by Ruan Yifeng sprawdza wersję JavaScript obsługiwaną w przeglądarce w czasie uruchamiania. ES Check oferuje podobne informacje zwrotne do Es Checker, ale w czasie budowy i jest specyficzny dla produktu, który go używa. Es Check został uruchomiony po przeczytaniu tego postu o Philip Walton.
es Check ma 3 główne zależności: acorn, glob i caporal. Aby przyczynić się, Zgłoś problem lub wyślij pull request.
- Jeff Wainwright
- Brian Gonzalez
- Jon ONG
- Suhas Karanth
- Ben Junya
- Jeff Barczewski
- Brandon Casey
