npm

Sjekk JavaScript-filer ES versjon mot en spesifisert ES versjon 🏆

ES Check sjekker JavaScript-filer mot en spesifisert versjon Av ECMAScript (ES) med en shell-kommando. HVIS ES-versjonen til EN bestemt fil ikke samsvarer MED argumentet ES-versjon som er sendt i es-Kontrollkommandoen, vil ES-Kontroll kaste en feil og logge filene som ikke stemte overens med sjekken.

Sikre At JavaScript-filer kan passere ES Sjekk er viktig i en modulær og samlet verden. Les mer om hvorfor.

Kom I Gang HVORFOR ES Sjekk? Bruk Gå GJENNOM API Debugging Bidragende Problemer

Kom I Gang

Installer

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

Sjekk om en matrise eller glob av filer samsvarer med en spesifisert ES-versjon.

• Merk: legger til tilbud rundt globs. Globs er mønstre som så, <something>/*.js.

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

• es Check script (over) sjekker /dist/*.js filer for Å se OM DE ER ES5. Det kaster en feil og logger filer er som ikke passerer sjekken.

HVORFOR Es Sjekk?

i moderne JavaScript bygger, er filene samlet opp slik at de kan serveres på en optimalisert måte i nettleserne. Det antas av utviklere at fremtidig JavaScript-lignende ES8 vil bli transpilert (endret fra fremtidig JavaScript til nåværende JavaScript) på riktig måte av Et verktøy som Babel. Noen ganger er det et problem der filene ikke er transpiled. Det var ingen effektiv måte å teste for filer som ikke ble transpilert-til nå. DET ER DET ES Check gjør.

Gå gjennom

bildene nedenfor viser kommandolinjeskript og tilhørende loggede resultater.

Pass

Mislykkes

Es-Kontroll kjøres over med nodekommandoer. Det kan også kjøres i npm skript, ci verktøy, eller testing suiter.

API

ES Sjekk gir nødvendigheter. Den aksepterer sin plass som En JavaScript matcher/tester.

Generell Informasjon

# USAGEindex.js es-check <ecmaVersion> 

Argumenter

<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

Alternativer

Moduler Flagg

--module use ES modules, default false

Tillat Hash Bang

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

Ikke

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

Globale Alternativer

-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

Bruk

ES-Kontroll er en shell-kommando CLI. Det kjøres i shell verktøy Som Terminal, ITerm, Eller Hyper. Det tar i to argumenter: En ECMAScript-versjon (<ECMAScript version>) og filer () i globs.

Her er noen eksempel på es sjekk skript som kan kjøres:

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

Konfigurasjon

hvis du bruker en konsekvent konfigurasjon, kan du opprette en .escheckrc – fil I json-format med argumentene ecmaVersion og files, slik at du enkelt kan kjøre es-check frittstående fra kommandolinjen.

her er et eksempel på hvordan en .escheckrc – fil vil se ut:

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

⚠️ OBS!: bruk av kommandolinjeargumenter mens det er en .escheckrc – fil i prosjektmappen vil overstyre konfigurasjonsverdiene i .escheckrc.

Feilsøking

SOM AV ES-Sjekk versjon 2.0.2, et bedre feilsøkingsgrensesnitt er gitt. Når en fil feil, vil en feil objekt logges med:

• feilfilen
• feilen
• feilstakken

⚠️ MERK: Feillogger er fra Acorn-parseren mens du analyserer JavaScript relatert til bestemte versjoner Av ECMAScript. Dette betyr at feilmeldinger ikke er spesifikke For ECMAScript-versjonen. Det gir fortsatt sammenheng i parsing problemer!

Takk

ES Check er et lite verktøy ved hjelp av kraftige verktøy Som Isaac Z. Schlueter, Marijn Haverbeke og Matthias Etienne bygget. ES Checker av Ruan YiFeng sjekker JavaScript-versjonen som støttes i en nettleser under kjøring. ES Check tilbyr lignende tilbakemelding TIL ES Checker, men på byggetid og er spesifikk for produktet som bruker DET. ES Check ble startet etter å ha lest dette innlegget om Av Philip Walton.

Bidragende

ES-Kontroll har 3 hovedavhengigheter: acorn, glob og caporal. For å bidra, sende inn et problem eller sende inn en pull-forespørsel.

Bidragsytere

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