npm

zkontrolujte JavaScript soubory es verzi proti zadané es verzi 🏆

es kontrola kontroluje soubory JavaScriptu proti zadané verzi ECMAScript (ES) pomocí příkazu shell. Pokud verze es zadaného souboru neodpovídá argumentu verze ES předanému v příkazu es Check, es Check vyvolá chybu a zaznamená soubory, které neodpovídaly kontrole.

zajištění toho, aby soubory JavaScript mohly projít kontrolou ES, je důležité v modulárním a svázaném světě. Přečtěte si více o tom, proč.

Začínáme proč es Check? Usage procházka API ladění přispívající problémy

Začínáme

instalovat

npm i es-check --save-dev # locallynpm i es-check -g # or globally

zkontrolujte, zda pole nebo glob souborů odpovídá zadané verzi ES.

• Poznámka: přidá nabídku kolem globs. Globs jsou vzory jako tak, <something>/*.js.

es-check es5 './vendor/js/*.js' './dist/**/*.js'

• skript es Check (výše) zkontroluje /dist/*.js soubory, aby zjistil, zda se jedná o ES5. To hodí chybu a protokoly soubory jsou, že neprojdou kontrolou.

proč es Check?

v moderních sestavách JavaScriptu jsou soubory svázány, takže mohou být v prohlížečích optimalizovány. Vývojáři předpokládají, že budoucí JavaScript podobný ES8 bude transpiled (změněn z budoucího JavaScriptu na současný JavaScript) vhodně nástrojem, jako je Babel. Někdy je problém, kdy soubory nejsou transpirovány. Neexistoval žádný účinný způsob testování souborů, které nebyly transpirovány—až dosud. To je to, co ES Check dělá.

projděte

níže uvedené obrázky ukazují skripty příkazového řádku a jejich odpovídající zaznamenané výsledky.

Pass

Fail

es Check je spuštěn výše s příkazy uzlu. Může být také spuštěn v skriptech npm, nástrojích ci nebo testovacích sadách.

API

es Check poskytuje potřeby. Přijímá své místo jako JavaScript matcher / tester.

Obecné Informace

# 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

volby

modules Flag

--module use ES modules, default false

povolit Hash Bang

--allow-hash-bang supports files that start with hash bang, default false

ne

--not=folderName1,folderName2 An array of file/folder names or globs that you would like to ignore. Defaults to ``.

Globální Možnosti

-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

použití

es Check je příkaz CLI shellu. Je spuštěn v nástroji shellu, jako je terminál, ITerm nebo Hyper. To trvá ve dvou argumentech: verze ECMAScript (<ECMAScript version>) a soubory () v globs.

zde je několik příkladů kontrolních skriptů es, které lze spustit:

# globses-check ./js/*.js# array of argumentses-check ./js/*.js ./dist/*.js

konfigurace

pokud používáte konzistentní konfiguraci, můžete vytvořit soubor .escheckrc ve formátu JSON s argumenty ecmaVersion a files, takže můžete pohodlně spustit es-check Samostatně z příkazového řádku.

zde je příklad toho, jak bude soubor .escheckrc vypadat:

{ "ecmaVersion": "es6", "module": false, "files": "./dist/**/*.js", "not": }

⚠️ poznámka: použití argumentů příkazového řádku, pokud je v adresáři projektu soubor .escheckrc, přepíše konfigurační hodnoty v .escheckrc.

ladění

od ES-Check verze 2.0.2, lepší ladění rozhraní je k dispozici. Při chybě souboru bude objekt chyby zaznamenán pomocí:

• soubor chyb
• chyba
• zásobník chyb

⚠️ poznámka: chybové protokoly pocházejí z analyzátoru Acorn při analýze JavaScriptu související s konkrétními verzemi ECMAScript. To znamená, že chybové zprávy nejsou specifické pro verzi ECMAScript. Stále nabízí kontext do problémů s analýzou!

poděkování

es Check je malý nástroj využívající výkonné nástroje, které postavili Isaac z.Schlueter, Marijn Haverbeke a Matthias Etienne. Es Checker od Ruan YiFeng kontroluje verzi JavaScriptu podporovanou v prohlížeči za běhu. ES Check nabízí podobnou zpětnou vazbu jako Es Checker, ale v době sestavení a je specifický pro produkt, který jej používá. Es kontrola byla zahájena po přečtení tohoto příspěvku o Philip Walton.

přispívající

es Check má 3 hlavní závislosti: acorn, glob a caporal. Přispět, podat problém nebo podat žádost o pull.

Přispěvatelé

• Jeff Wainwright
• Brian Gonzalez
• Jon Ong
• Suhas Karanth
• Ben Junya
• Jeff Barczewski
• Brandon Casey