npm

Vérifiez la version ES des fichiers JavaScript par rapport à une version ES spécifiée 🏆

ES Check vérifie les fichiers JavaScript par rapport à une version spécifiée d’ECMAScript(ES) avec une commande shell. Si la version ES d’un fichier spécifié ne correspond pas à l’argument version ES passé dans la commande ES Check, ES Check génère une erreur et enregistre les fichiers qui ne correspondent pas à la vérification.

Il est important de s’assurer que les fichiers JavaScript peuvent passer la vérification ES dans un monde modulaire et groupé. En savoir plus sur pourquoi.

Commencer Pourquoi Vérifier ES? Utilisation Parcourir Les Problèmes de Contribution au Débogage de l’API

Démarrer

Installer

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

Vérifiez si un tableau ou un glob de fichiers correspond à une version ES spécifiée.

• Remarque: ajoute une citation autour de globs. Les globes sont des modèles comme, <something>/*.js.

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

• Le script de vérification ES (ci-dessus) vérifie les fichiers /dist/*.js pour voir s’ils sont ES5. Il génère une erreur et enregistre les fichiers qui ne passent pas la vérification.

Pourquoi Vérifier?

Dans les versions JavaScript modernes, les fichiers sont regroupés afin qu’ils puissent être servis de manière optimisée dans les navigateurs. Il est supposé par les développeurs que le futur ES8 de type JavaScript sera transpilé (passé du futur JavaScript au JavaScript actuel) de manière appropriée par un outil comme Babel. Parfois, il y a un problème où les fichiers ne sont pas transpilés. Il n’y avait aucun moyen efficace de tester les fichiers qui n’étaient pas transpilés — jusqu’à présent. C’est ce que fait ES Check.

Parcourez

Les images ci-dessous montrent les scripts de ligne de commande et leurs résultats journalisés correspondants.

Pass

Fail

La vérification ES est exécutée ci-dessus avec les commandes de nœud. Il peut également être exécuté dans des scripts npm, des outils ci ou des suites de tests.

API

ES Check fournit les nécessités. Il accepte sa place en tant que matcher / testeur JavaScript.

Informations générales

# USAGEindex.js es-check <ecmaVersion> 

Arguments

<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

Options

Drapeau des modules

--module use ES modules, default false

Autoriser le Coup de Hachage

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

Pas

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

Options 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

Utilisation

La vérification ES est une commande shell CLI. Il est exécuté dans un outil shell comme Terminal, ITerm ou Hyper. Il prend deux arguments : une version ECMAScript (<ECMAScript version>) et des fichiers () en globs.

Voici quelques exemples de scripts de vérification es qui pourraient être exécutés:

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

Configuration

Si vous utilisez une configuration cohérente, vous pouvez créer un fichier .escheckrc au format JSON avec les arguments ecmaVersion et files afin de pouvoir exécuter es-check de manière autonome à partir de la ligne de commande.

Voici un exemple de ce à quoi ressemblera un fichier .escheckrc:

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

⚠️ REMARQUE : L’utilisation d’arguments de ligne de commande alors qu’il y a un fichier .escheckrc dans le répertoire du projet remplacera les valeurs de configuration dans .escheckrc.

Débogage

À partir de la version ES-Check 2.0.2, une meilleure interface de débogage est fournie. Lorsqu’un fichier est en erreur, un objet d’erreur sera enregistré avec:

• le fichier d’erreur
• l’erreur
• la pile d’erreurs

⚠️ REMARQUE : Les journaux d’erreurs proviennent de l’analyseur Acorn lors de l’analyse de JavaScript lié à des versions spécifiques d’ECMAScript. Cela signifie que la messagerie d’erreur n’est pas spécifique à la version ECMAScript. Il offre toujours un contexte pour analyser les problèmes!

Remerciements

ES Check est un petit utilitaire utilisant des outils puissants que Isaac Z. Schlueter, Marijn Haverbeke et Matthias Etienne ont construits. ES Checker de Ruan YiFeng vérifie la version JavaScript prise en charge dans un navigateur au moment de l’exécution. ES Check offre des commentaires similaires à ES Checker mais au moment de la construction et est spécifique au produit qui l’utilise. ES Check a été lancé après avoir lu ce post sur par Philip Walton.

Contribuer

La vérification ES a 3 dépendances principales: acorn, glob et caporal. Pour contribuer, déposez un problème ou soumettez une demande de tirage.

Contributeurs

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