npm

Controllare la versione ES dei file JavaScript rispetto a una versione ES specificata🏆

ES Check controlla i file JavaScript rispetto a una versione specificata di ECMAScript (ES) con un comando shell. Se la versione ES di un file specificato non corrisponde all’argomento ES version passato nel comando ES Check, ES Check genererà un errore e registrerà i file che non corrispondono al check.

Garantire che i file JavaScript possano passare il controllo ES è importante in un mondo modulare e in bundle. Per saperne di più sul perché.

Per iniziare Perché ES Check? Utilizzo Walk Through API Debug Contribuire problemi

Iniziare

Installare

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

Controlla se un array o un glob di file corrisponde a una versione ES specificata.

• Nota: aggiunge citazione intorno globs. I glob sono modelli come così, <something>/*.js.

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

• Lo script di controllo ES (sopra) controlla i file /dist/*.js per vedere se sono ES5. Genera un errore e registra i file che non passano il controllo.

Perché ES Controllare?

Nelle moderne build JavaScript, i file sono raggruppati in modo che possano essere serviti in modo ottimizzato nei browser. Si presume dagli sviluppatori che il futuro ES8 simile a JavaScript verrà traspilato (cambiato da JavaScript futuro a JavaScript corrente) in modo appropriato da uno strumento come Babel. A volte c’è un problema in cui i file non vengono transpiled. Non c’era un modo efficace per testare i file che non sono stati transpiled—fino ad ora. Questo è ciò che fa ES Check.

Scorrere

Le immagini sottostanti mostrano gli script della riga di comando e i relativi risultati registrati.

Passa

Fail

Il controllo ES viene eseguito sopra con i comandi node. Può anche essere eseguito all’interno di script npm, strumenti ci o suite di test.

API

ES Check fornisce le necessità. Accetta il suo posto come un matcher/tester JavaScript.

Informazioni Di Carattere Generale

# USAGEindex.js es-check <ecmaVersion> 

Argomenti

<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

Opzioni

Moduli Di Bandiera

--module use ES modules, default false

Permettono Di Hash Bang

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

Non

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

Opzioni Globali

-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

Utilizzo

ES Check è una shell di comando CLI. Viene eseguito in uno strumento di shell come Terminal, ITerm o Hyper. Prende in due argomenti: una versione ECMAScript (<ECMAScript version>) e file () in globs.

Ecco alcuni esempi di script di controllo es che potrebbero essere eseguiti:

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

Configurazione

Se si utilizza una configurazione coerente, è possibile creare un file .escheckrc in formato JSON con gli argomenti ecmaVersion e files in modo da poter eseguire comodamente es-check standalone dalla riga di comando.

Ecco un esempio di come apparirà un file .escheckrc :

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

⚠️ NOTA: l’utilizzo di argomenti della riga di comando mentre è presente un file .escheckrcnella directory del progetto sovrascriverà i valori di configurazione in .escheckrc.

Debug

A partire da ES-Check versione 2.0.2, una migliore interfaccia di debug è fornito. Quando un file di errori, Un oggetto di errore verrà registrato con:

• il file di errore
• l’errore
• lo stack di errore

⚠️ NOTA: i log degli errori provengono dal parser Acorn durante l’analisi di JavaScript relativi a versioni specifiche di ECMAScript. Ciò significa che la messaggistica di errore non è specifica per la versione ECMAScript. Offre ancora contesto in problemi di analisi!

Ringraziamenti

ES Check è una piccola utility che utilizza potenti strumenti creati da Isaac Z. Schlueter, Marijn Haverbeke e Matthias Etienne. ES Checker di Ruan YiFeng controlla la versione JavaScript supportata all’interno di un browser in fase di esecuzione. ES Check offre un feedback simile a ES Checker ma in fase di compilazione ed è specifico per il prodotto che lo utilizza. ES controllo è stato avviato dopo aver letto questo post su da Philip Walton.

Contributing

ES Check ha 3 dipendenze principali: acorn, glob e caporal. Per contribuire, presentare un problema o inviare una richiesta pull.

Collaboratori

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