npm

Seleção de arquivos JavaScript (versão ES contra uma determinada versão ES 🏆

ES de Verificação verifica arquivos JavaScript contra uma versão especificada do ECMAScript (ES) com um comando do shell. Se a versão ES de um arquivo especificado não corresponder ao argumento ES version passado no comando es Check, O ES Check emitirá um erro e registrará os arquivos que não corresponderam à verificação.

garantir que os arquivos JavaScript possam passar na verificação ES é importante em um mundo modular e empacotado. Leia mais sobre o porquê.

começar por que es verificar? Uso Percorra problemas de Contribuição de depuração de API

introdução

instalar

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

verifique se uma matriz ou glob de arquivos corresponde a uma versão es especificada.

• Nota: adiciona cotação em torno de globs. Globs são padrões assim, <something>/*.js.

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

• o script de verificação ES (acima) verifica /dist/*.js arquivos para ver se eles são ES5. Ele gera um erro e os arquivos de logs são que não passam na verificação.

Por Que es verificar?

em compilações JavaScript modernas, os arquivos são agrupados para que possam ser servidos de maneira otimizada nos navegadores. É assumido pelos desenvolvedores que o futuro ES8 semelhante ao JavaScript será transpilado (alterado do JavaScript futuro para o JavaScript atual) apropriadamente por uma ferramenta como o Babel. Às vezes, há um problema em que os arquivos não são transpilados. Não havia uma maneira eficiente de testar arquivos que não foram transpilados—até agora. É isso que o ES Check faz.

Percorra

as imagens abaixo demonstram scripts de linha de comando e seus resultados registrados correspondentes.

Pass

Fail

a verificação ES é executada acima com comandos de nó. Ele também pode ser executado em scripts npm, ferramentas ci ou suítes de teste.

API

es Check fornece as necessidades. Ele aceita seu lugar como um JavaScript matcher / tester.

Informações Gerais

# 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

Opções

Módulos Bandeira

--module use ES modules, default false

Permitir Hash-Bang

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

Não

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

Opções Globais

-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

o Uso de

ES de Seleção é um shell de comando (CLI). Ele é executado na ferramenta shell como Terminal, ITerm ou Hyper. Leva em dois argumentos: uma versão ECMAScript (<ECMAScript version>) e arquivos () em globs.

Aqui estão alguns exemplos de scripts de verificação es que podem ser executados:

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

configuração

se você estiver usando uma configuração consistente, poderá criar um arquivo .escheckrc no formato JSON com os argumentos ecmaVersion e files para que você possa executar convenientemente es-check autônomo na linha de comando.

aqui está um exemplo de como será um arquivo .escheckrc :

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

⚠️ observação: usar argumentos de linha de comando enquanto houver um arquivo .escheckrc no diretório do projeto substituirá os valores de configuração em .escheckrc.

depuração

a partir da versão 2.0 do ES-Check.2, uma melhor interface de depuração é fornecida. Quando um arquivo de erros, Um objeto de erro será registrada com:

• o erroring arquivo
• erro
• o erro de pilha

⚠️ NOTA: os logs de Erro são da Bolota analisador ao analisar o JavaScript relacionados às versões específicas do ECMAScript. Isso significa que as mensagens de erro não são específicas da versão ECMAScript. Ele ainda oferece contexto para analisar questões!

agradecimentos

es Check é um pequeno utilitário usando ferramentas poderosas que Isaac Z. Schlueter, Marijn Haverbeke e Matthias Etienne construíram. Es Checker by Ruan Yifeng verifica a versão JavaScript suportada em um navegador em tempo de execução. O es Check oferece feedback semelhante ao Es Checker, mas no momento da compilação e é específico para o produto que o está usando. Es Check foi iniciado depois de ler este post sobre por Philip Walton.

contribuir

es Check tem 3 dependências principais: bolota, glob e caporal. Para contribuir, arquive um problema ou envie uma solicitação pull.

Contribuintes

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