Comprobar la versión ES de los archivos JavaScript con una versión ES especificada🏆
ES Check comprueba los archivos JavaScript con una versión especificada de ECMAScript (ES) con un comando de shell. Si la versión ES de un archivo especificado no coincide con el argumento versión ES pasado en el comando Comprobación de ES, Comprobación de ES arrojará un error y registrará los archivos que no coincidieron con la comprobación.
Garantizar que los archivos JavaScript puedan pasar la comprobación ES es importante en un mundo modular y agrupado. Lee más sobre por qué.
Empezar ¿Por qué Comprobar ES? Uso Recorrido por la depuración de API Problemas que contribuyen
Comenzar
Instalar
npm i es-check --save-dev # locallynpm i es-check -g # or globally
Compruebe si una matriz o un conjunto de archivos coincide con una versión ES especificada.
- Nota: agrega citas alrededor de los globos. Los globos son patrones así,
<something>/*.js
.
es-check es5 './vendor/js/*.js' './dist/**/*.js'
- El script de verificación ES (arriba) comprueba los archivos
/dist/*.js
para ver si son ES5. Lanza un error y los archivos de registro son que no pasan la comprobación.
¿Por qué comprobar ES?
En las compilaciones modernas de JavaScript, los archivos se agrupan para que se puedan servir de manera optimizada en los navegadores. Los desarrolladores asumen que el futuro ES8 similar a JavaScript será transpilado (cambiado de JavaScript futuro a JavaScript actual) apropiadamente por una herramienta como Babel. A veces hay un problema en el que los archivos no se transpilan. No había una forma eficiente de probar archivos que no se habían transpilado, hasta ahora. Eso es lo que hace ES Check.
Recorrer
Las siguientes imágenes muestran scripts de línea de comandos y sus correspondientes resultados registrados.
Pass
Fail
La comprobación ES se ejecuta arriba con comandos de nodo. También se puede ejecutar dentro de scripts npm, herramientas de ci o conjuntos de pruebas.
API
ES Check proporciona las necesidades. Acepta su lugar como un matcher/probador de JavaScript.
Información General
# USAGEindex.js es-check <ecmaVersion>
Argumentos
<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
Opciones
Módulos Bandera
--module use ES modules, default false
Permitir Hash Bang
--allow-hash-bang supports files that start with hash bang, default false
No
--not=folderName1,folderName2 An array of file/folder names or globs that you would like to ignore. Defaults to ``.
Opciones Globales
-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
el Uso de
ES Comprobar es un shell de comandos de la CLI. Se ejecuta en una herramienta de shell como Terminal, ITerm o Hyper. Toma dos argumentos: una versión ECMAScript (<ECMAScript version>
) y archivos () en globs.
Aquí hay algunos ejemplos de scripts de comprobación de es que se podrían ejecutar:
# globses-check ./js/*.js# array of argumentses-check ./js/*.js ./dist/*.js
Configuración
Si utiliza una configuración coherente, puede crear un archivo .escheckrc
en formato JSON con los argumentos ecmaVersion
y files
para poder ejecutar cómodamente es-check
independiente desde la línea de comandos.
Este es un ejemplo de cómo se verá un archivo .escheckrc
:
{ "ecmaVersion": "es6", "module": false, "files": "./dist/**/*.js", "not": }
⚠️ NOTA: Usar argumentos de línea de comandos mientras hay un archivo .escheckrc
en el directorio del proyecto anulará los valores de configuración en .escheckrc
.
Depuración
A partir de ES-Check versión 2.0.2, se proporciona una mejor interfaz de depuración. Cuando se produce un error en un archivo, se registra un objeto de error con:
- el archivo de error
- el error
- la pila de errores
⚠️ NOTA: Los registros de errores son del analizador de Acorn mientras se analiza JavaScript relacionado con versiones específicas de ECMAScript. Esto significa que la mensajería de errores no es específica de la versión de ECMAScript. ¡Todavía ofrece contexto para analizar problemas!
Agradecimientos
ES Check es una pequeña utilidad que utiliza herramientas poderosas que Isaac Z. Schlueter, Marijn Haverbeke y Matthias Etienne construyeron. ES Checker de Ruan YiFeng comprueba la versión de JavaScript compatible con un navegador en tiempo de ejecución. ES Check ofrece comentarios similares a ES Checker, pero en el momento de la compilación y es específico para el producto que lo está utilizando. Check se inició después de leer este post de Philip Walton.
Contributing
ES Check tiene 3 dependencias principales: acorn, glob y caporal. Para contribuir, presentar un problema o enviar una solicitud de extracción.
Colaboradores
- Jeff Wainwright
- Brian González
- Jon Ong
- Suhas Karanth
- Ben Junya
- Jeff Barczewski
- Brandon Casey