指定されたESバージョンに対してJavaScriptファイルESバージョンを確認する🏆
ES Checkは、シェルコマンドを使用して、指定されたバージョンのECMAScript(ES)に対してJavaScriptファイルをチェックします。 指定されたファイルのESバージョンがES Checkコマンドで渡されたES version引数と一致しない場合、ES Checkはエラーをスローし、チェックに一致しなかったファイルを
JavaScriptファイルがESチェックに合格できるようにすることは、モジュール化されたバンドルされた世界で重要です。 理由についての詳細を読みます。
はじめになぜESチェック? Apiデバッグの使用方法貢献する問題
はじめに
インストール
npm i es-check --save-dev # locallynpm i es-check -g # or globally
ファイルの配列またはglobが指定されたESバージョンと一致するかどうかを確認します。
- 注:グロブの周りに引用を追加します。 グロブは
<something>/*.js
のようなパターンです。
es-check es5 './vendor/js/*.js' './dist/**/*.js'
- ESチェックスクリプト(上記)は、
/dist/*.js
ファイルをチェックして、ES5であるかどうかを確認します。 これは、エラーをスローし、ログファイルは、チェックに合格していないことです。
なぜESチェック?
最新のJavaScriptビルドでは、ファイルがバンドルされているため、ブラウザで最適化された方法で提供できます。 開発者は、将来のJavaScriptのようなES8がBabelのようなツールによって適切にトランスパイルされる(将来のJavaScriptから現在のJavaScriptに変更される)と仮定しています。 ファイルが転置されない問題があることがあります。 今までは、トランスコンパイルされていないファイルをテストする効率的な方法はありませんでした。 それはESチェックが何をするかです。
以下の画像は、コマンドラインスクリプトとそれに対応するログ結果を示しています。
PASS
Fail
ESチェックは上記のノードコマンドで実行されます。 また、npmスクリプト、ciツール、またはテストスイート内で実行することもできます。
API
ESチェックは必需品を提供します。 それはJavaScript matcher/testerとしてその場所を受け入れます。
総合情報
# USAGEindex.js es-check <ecmaVersion>
引数
<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
オプション
モジュールフラグ
--module use ES modules, default false
ハッシュバンを許可する
--allow-hash-bang supports files that start with hash bang, default false
ない
--not=folderName1,folderName2 An array of file/folder names or globs that you would like to ignore. Defaults to ``.
グローバルオプション
-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
使用法
ES CheckはシェルコマンドCLIです。 これは、Terminal、ITerm、Hyperなどのシェルツールで実行されます。 これは2つの引数を取ります:ECMAScriptバージョン(<ECMAScript version>
)とファイル()globs。
実行できるesチェックスクリプトの例を次に示します:
# globses-check ./js/*.js# array of argumentses-check ./js/*.js ./dist/*.js
構成
一貫した構成を使用している場合は、ecmaVersion
およびfiles
引数を使用してJSON形式の.escheckrc
ファイルを作成できるため、コマンドラインからes-check
standaloneを便利に実行で
.escheckrc
ファイルがどのように見えるかの例を次に示します:
{ "ecmaVersion": "es6", "module": false, "files": "./dist/**/*.js", "not": }
⚠️ 注:プロジェクトディレクトリに.escheckrc
ファイルがあるときにコマンドライン引数を使用すると、.escheckrc
の構成値が上書きされます。
デバッグ
ES-Checkバージョン2.0以降。2つは、よりよいデバッグインターフェイス提供されます。 ファイルエラーが発生した場合、エラーオブジェクトは次のようにログに記録されます:
- エラーファイル
- エラー
- エラースタック
⚠️ 注意:ECMAScriptの特定のバージョンに関連するJavaScriptを解析している間のエラーログはAcorn parserからのものです。 これは、error messagingがECMAScriptのバージョンに固有のものではないことを意味します。 それはまだ解析の問題に文脈を提供しています!
謝辞
ES Checkは、Isaac Z.Schlueter、Marijn Haverbeke、Matthias Etienneが構築した強力なツールを使用した小さなユーティリティです。 Ruan YiFengによるES Checkerは、実行時にブラウザ内でサポートされているJavaScriptのバージョンをチェックします。 ES Checkは、ES Checkerと同様のフィードバックを提供しますが、ビルド時には、それを使用している製品に固有のものです。 ESチェックは、Philip Waltonによるこの記事を読んだ後に開始されました。
ESチェックには、acorn、glob、caporalの3つの主要な依存関係があります。 投稿するには、課題を提出するか、プルリクエストを送信します。
貢献者
- ジェフ-ウェインライト
- ブライアン-ゴンザレス
- ジョン-オング
- スハス-カラント
- ベン-ジュンヤ
- ジェフ-バルチェフスキ
- ブランドン-ケーシー