npm

kontrollera JavaScript-filer ES-version mot en angiven ES-version 🏆

ES Check kontrollerar JavaScript-filer mot en viss version av ECMAScript (ES) med ett skalkommando. Om en angiven fils ES-version inte matchar ES-versionsargumentet som skickas i kommandot ES Check, kommer ES Check att kasta ett fel och logga de filer som inte matchade kontrollen.

att se till att JavaScript-filer kan passera ES-kontrollen är viktigt i en modulär och buntad Värld. Läs mer om varför.

Kom igång varför ES Check? Användning gå igenom API felsökning bidragande frågor

komma igång

installera

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

kontrollera om en array eller glob av filer matchar en angiven ES-version.

• Obs: lägger citat runt globs. Globs är mönster som så, <something>/*.js.

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

• ES Check script (ovan) kontrollerar /dist/*.js filer för att se om de är ES5. Det kastar ett fel och loggar filer är att inte passera kontrollen.

varför ES kontrollera?

i moderna JavaScript-byggnader samlas filer så att de kan serveras på ett optimerat sätt i webbläsarna. Det antas av utvecklare att framtida JavaScript-liknande ES8 kommer att transpileras (ändras från framtida JavaScript till nuvarande JavaScript) på lämpligt sätt av ett verktyg som Babel. Ibland finns det ett problem där filer inte transpileras. Det fanns inget effektivt sätt att testa för filer som inte transpilerades—tills nu. Det är vad ES Check gör.

gå igenom

bilderna nedan visar kommandoradsskript och deras motsvarande loggade resultat.

Pass

Fail

ES Check körs ovan med nodkommandon. Det kan också köras inom npm-skript, ci-verktyg eller testsviter.

API

ES Check ger nödvändigheter. Den accepterar sin plats som en JavaScript matcher/tester.

allmän Information

# USAGEindex.js es-check <ecmaVersion> 

argument

<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

alternativ

moduler flagga

--module use ES modules, default false

Tillåt Hash Bang

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

inte

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

globala alternativ

-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

användning

ES Check är ett skalkommando CLI. Det körs i skalverktyg som Terminal, ITerm eller Hyper. Det tar in två argument: en ECMAScript-version (<ECMAScript version>) och filer () i globs.

här är några exempel på es – kontrollskript som kan köras:

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

konfiguration

om du använder en konsekvent konfiguration kan du skapa en .escheckrc fil i JSON-format med argumenten ecmaVersion och files så att du enkelt kan köra es-check fristående från kommandoraden.

här är ett exempel på hur en .escheckrc – fil kommer att se ut:

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

⚠️ om du använder kommandoradsargument medan det finns en .escheckrc – fil i projektkatalogen åsidosätts konfigurationsvärdena i .escheckrc.

felsökning

från och med ES-kontrollera version 2.0.2, ett bättre felsökningsgränssnitt tillhandahålls. När en fil fel, kommer ett fel objekt loggas med:

• felfilen
• felet
• felstacken

⚠️ Obs: felloggar är från Acorn parser medan Tolkning JavaScript relaterade till specifika versioner av ECMAScript. Det betyder att felmeddelanden inte är specifika för ECMAScript-versionen. Det erbjuder fortfarande sammanhang i parsningsfrågor!

bekräftelser

ES Check är ett litet verktyg med kraftfulla verktyg som Isaac Z. Schlueter, Marijn Haverbeke och Matthias Etienne byggde. ES Checker av Ruan YiFeng kontrollerar JavaScript-versionen som stöds i en webbläsare vid körning. ES Check erbjuder liknande feedback till ES Checker men vid byggtid och är specifik för den produkt som använder den. ES Check startades efter att ha läst detta inlägg om av Philip Walton.

bidragande

ES-kontrollen har 3 huvudberoenden: ekollon, glob och caporal. För att bidra, lämna in ett problem eller skicka en pull-begäran.

Bidragsgivare

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