npm

Controleer JavaScript bestanden ES versie tegen een opgegeven ES versie 🏆

ES Check controleert JavaScript-bestanden met een opgegeven versie van ECMAScript (ES) met een shell-opdracht. Als de ES-versie van een opgegeven bestand niet overeenkomt met het Es-versieargument dat is doorgegeven in het Es Check-commando, zal ES Check een fout gooien en de bestanden loggen die niet overeenkomen met de check.

ervoor zorgen dat JavaScript-bestanden ES-Check kunnen doorstaan is belangrijk in een modulaire en gebundelde wereld. Lees meer over waarom.

aan de slag waarom ES Check? Gebruik Loop door API-foutopsporing bijdragende problemen

aan de slag

installeren

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

Controleer of een array of glob van bestanden overeenkomt met een opgegeven ES-versie.

• opmerking: voegt citaten toe rond globs. Globs zijn patronen zoals deze, <something>/*.js.

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

• het Es Check script (hierboven) controleert /dist/*.js bestanden om te zien of ze ES5 zijn. Het gooit een fout en logs bestanden zijn die niet voorbij de controle.

waarom ES Check?

in moderne JavaScript-builds worden bestanden gebundeld zodat ze op een geoptimaliseerde manier kunnen worden geserveerd in de browsers. Het wordt aangenomen door ontwikkelaars dat toekomstige JavaScript-achtige ES8 zal worden omgezet (veranderd van toekomstige JavaScript naar huidige JavaScript) op de juiste wijze door een tool als Babel. Soms is er een probleem waarbij bestanden niet worden omgezet. Er was geen efficiënte manier om te testen voor bestanden die niet werden omgezet—tot nu toe. Dat is wat ES Check doet.

loop door

de afbeeldingen hieronder tonen opdrachtregelscripts en de bijbehorende gelogde resultaten.

Pass

Fail

ES-controle wordt hierboven uitgevoerd met node-opdrachten. Het kan ook worden uitgevoerd binnen NPM scripts, ci tools, of testen suites.

API

ES-controle biedt de benodigdheden. Het accepteert zijn plaats als een JavaScript matcher/tester.

Algemene Informatie

# USAGEindex.js es-check <ecmaVersion> 

Argumenten

<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

Opties

Modules Vlag

--module use ES modules, default false

Laat Hash Bang

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

Niet

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

Globale Opties

-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

Gebruik

ES Check is een shell-commando CLI. Het wordt uitgevoerd in shell tool zoals Terminal, ITerm, of Hyper. Het bevat twee argumenten: een ECMAScript-versie (<ECMAScript version>) en bestanden () in globs.

hier zijn enkele voorbeelden van Es check scripts die kunnen worden uitgevoerd:

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

configuratie

Als u een consistente configuratie gebruikt, kunt u een bestand .escheckrc in JSON-formaat aanmaken met de argumenten ecmaVersion en files, zodat u gemakkelijk es-check zelfstandig kunt uitvoeren vanaf de opdrachtregel.

hier is een voorbeeld van hoe een .escheckrc bestand eruit zal zien:

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

⚠️ opmerking: het gebruik van commandoregelargumenten terwijl er een .escheckrc bestand in de projectmap is, zal de configuratiewaarden in .escheckrcoverschrijven.

Debugging

vanaf ES-Check versie 2.0.2, een betere debugging interface is voorzien. Wanneer een bestand fouten, een fout object zal worden gelogd met:

• het foutbestand
• de fout
• de foutenlijst

⚠️ opmerking: Error logs zijn van de Acorn parser tijdens het ontleden van JavaScript met betrekking tot specifieke versies van ECMAScript. Dit betekent foutberichten is niet specifiek voor ECMAScript-versie. Het biedt nog steeds context in het ontleden van problemen!

Dankbetuigingen

ES Check is een klein programma dat krachtige tools gebruikt die Isaac Z. Schlueter, Marijn Haverbeke en Matthias Etienne hebben gebouwd. ES Checker door Ruan YiFeng controleert de JavaScript-versie ondersteund binnen een browser op runtime. ES Check biedt vergelijkbare feedback aan ES Checker maar op bouwtijd en is specifiek voor het product dat het gebruikt. ES Check werd gestart na het lezen van deze post over door Philip Walton.

bijdragende

ES-controle heeft 3 hoofdafhankelijkheden: acorn, glob en caporal. Om bij te dragen, een probleem in te dienen of een pull request in te dienen.

Bijdragers

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