Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More →
standard
Advanced tools
standard - npm Package Compare versions
Comparing version 10.0.1 to 10.0.2
@@ -92,3 +92,4 @@ # Authors | ||
| - Thomas Watson (w@tson.dk) | ||
| - Pablo Varela (pablopunk@users.noreply.github.com) | ||
| #### Generated by bin/update-authors.sh. |
@@ -6,2 +6,9 @@ # Change Log | ||
| ## 10.0.2 - 2017-04-14 | ||
| ### Changed rules | ||
| - Relax rule: Disallow import of modules using absolute paths ([import/no-absolute-path](https://github.com/benmosher/eslint-plugin-import/blob/master/docs/rules/no-absolute-path.md)) [#861](https://github.com/feross/standard/issues/861) | ||
| - This rule was responsible for up to 25% of the running time of `standard`, so we are disabling it until its performance improves. | ||
| ## 10.0.1 - 2017-04-06 | ||
@@ -8,0 +15,0 @@ |
@@ -22,3 +22,4 @@ <h1 align="center"> | ||
| <a href="README-ptbr.md">Português</a>, | ||
| <a href="README-zhtw.md">繁體中文</a> | ||
| <a href="README-zhtw.md">繁體中文</a>, | ||
| <a href="README-zhcn.md">简体中文</a> | ||
| </p> | ||
@@ -49,16 +50,16 @@ | ||
| - **2 espacios** como sangría. | ||
| - **Usar comillas simples en cadenas de texto** con la excepcion de escapado de texto | ||
| - **Usar comillas simples en cadenas de texto** con la excepción de escapado de texto | ||
| - **No dejar variables sin usar** – esta captura *toneladas* de bugs! | ||
| - **Sin punto y coma** – [Esta][1] [bien.][2] [En serio!][3] | ||
| - **Sin punto y coma** – [Está][1] [bien.][2] [¡En serio!][3] | ||
| - **Nunca empezar una línea con `(`, `[`, o `` ` ``** | ||
| - Este es ul **unico** problema al evitar punto y coma – *automaticamente verificado para ti!* | ||
| - Este es el **único** problema al evitar punto y coma – *automáticamente verificado para ti!* | ||
| - [Más detalles][4] | ||
| - **Espacio después de las palabras claves** `if (condition) { ... }` | ||
| - **Espacio después del nombre de función** `function name (arg) { ... }` | ||
| - Usar siempre `===` en vez de `==` – pero `obj == null` esta permitido para verificar `null || undefined`. | ||
| - Usar siempre `===` en vez de `==` – pero `obj == null` está permitido para verificar `null || undefined`. | ||
| - Gestionar siempre el parámetro de función `err` de node.js | ||
| - Usar siempre el prefijo `window` en los globales del navegador – A excepción de `document` y `navigator` esto esta bien | ||
| - Previene uso accidental de mal-llamados globales del navegador como `open`, `length`, | ||
| - Usar siempre el prefijo `window` en los globales del navegador – A excepción de `document` y `navigator` esto está bien | ||
| - Previene el uso accidental de mal-llamados globales del navegador como `open`, `length`, | ||
| `event`, y `name`. | ||
| - **Y [mucho mas][5]** – *prueba `standard` hoy mismo!* | ||
| - **Y [mucho más][5]** – *prueba `standard` hoy mismo!* | ||
@@ -79,26 +80,28 @@ [1]: http://blog.izs.me/post/2353458699/an-open-letter-to-javascript-leaders-regarding | ||
| - Inicio Rapido | ||
| - Inicio Rápido | ||
| - [Instalación](#instalación) | ||
| - [Uso](#uso) | ||
| - [Lo que podrias hacer si eres inteligente](#lo-que-prodias-hacer-si-eres-inteligente) | ||
| - [Lo que podrías hacer si eres inteligente](#lo-que-podrías-hacer-si-eres-inteligente) | ||
| - FAQ | ||
| - [¿Porque deberia usar JavaScript Standard Style?](#porque-deberia-usar-javascript-standard-style) | ||
| - [¿Quien usa JavaScript Standard Style?](#quien-usa-javascript-standard-style) | ||
| - [¿Por qué debería usar JavaScript Standard Style?](#por-qué-deberia-usar-javascript-standard-style) | ||
| - [¿Quién usa JavaScript Standard Style?](#quién-usa-javascript-standard-style) | ||
| - [¿Hay plugins para editores de textos?](#hay-plugins-para-editores-de-textos) | ||
| - [¿Hay alguna medalla para al readme?](#hay-alguna-medalla-para-al-readme) | ||
| - [No estoy de acuerdo con la regla X, ¿lo puedes cambiar?](#no-estoy-de-acuerdo-con-la-regla-x-lo-puedo-cambiar) | ||
| - [No estoy de acuerdo con la regla X, ¿la puedo cambiar?](#no-estoy-de-acuerdo-con-la-regla-x-la-puedo-cambiar) | ||
| - [¡Pero esto no un estandar web real!](#pero-esto-no-un-estandar-web-real) | ||
| - [¿Hay algún formateador automatico?](#hay-algún-formateador-automatico) | ||
| - [¿Como hago para ignorar archivos?](#como-hago-para-ignorar-archivos) | ||
| - [¿Como oculto cierta alerta?](#como-oculto-cierta-alerta) | ||
| - [Yo uso una librería que contamina el espacio de nombres global. ¿Como puedo evitar los errores "variable is not defined"?](#yo-uso-una-librería-que-contamina-el-espacio-de-nombres-global-como-puedo-evitar-los-errores--variable-is-not-defined) | ||
| - [¿Hay algún formateador automático?](#hay-algún-formateador-automático) | ||
| - [¿Cómo hago para ignorar archivos?](#cómo-hago-para-ignorar-archivos) | ||
| - [¿Cómo oculto cierta alerta?](#cómo-oculto-cierta-alerta) | ||
| - [Yo uso una librería que contamina el espacio de nombres global. ¿Cómo puedo evitar los errores "variable is not defined"?](#yo-uso-una-librería-que-contamina-el-espacio-de-nombres-global-cómo-puedo-evitar-los-errores--variable-is-not-defined) | ||
| - [¿Puedo usar un parser JavaScript que soporte ES última-generación?](#puedo-usar-un-parser-javascript-que-soporte-es-última-generación) | ||
| - [¿Puedo usar una variación de lenguaje JavaScript, como Flow?](#puedo-usar-una-variación-de-lenguaje-javascript-como-flow) | ||
| - [¿Que acerca de Mocha, Jasmine, QUnit y etc?](#que-acerca-de-mocha-jasmine-qunit-y-etc) | ||
| - [¿Que acerca de Web Workers?](#que-acerca-de-web-workers) | ||
| - [¿Puedo verificar codigo dentro de archivos Markdown o HTML?](#puedo-verificar-codigo-dentro-de-archivos-markdown-o-html) | ||
| - [¿Qué pasa con Mocha, Jasmine, QUnit y etc?](#qué-pasa-con-mocha-jasmine-qunit-y-etc) | ||
| - [¿Qué pasa con Web Workers?](#qué-pasa-con-web-workers) | ||
| - [¿Puedo verificar código dentro de archivos Markdown o HTML?](#puedo-verificar-codigo-dentro-de-archivos-markdown-o-html) | ||
| - [¿Hay algún gancho git `pre-commit`?](#hay-algún-gancho-git-pre-commit) | ||
| - [¿Como hago la salida (output) todo colorido y *bonito*?](#como-hago-la-salida-output-todo-colorido-y-bonito) | ||
| - [¿Cómo hago la salida (output) toda colorida y *bonita*?](#cómo-hago-la-salida-output-toda-colorida-y-bonita) | ||
| - [Node.js API](#nodejs-api) | ||
| - [¿Como puedo contribuir a `standard`?](#como-puedo-contribuir-a-standard) | ||
| - [¿Cómo puedo contribuir a `standard`?](#cómo-puedo-contribuir-a-standard) | ||
| - [Licencia](#licencia) | ||
@@ -108,3 +111,3 @@ | ||
| La manera más fácil de usar JavaScript Standard Style es instalarlo globalmente como un programa de linea de comandos de Node. Ejecuta el siguiente comando en la terminal: | ||
| La manera más fácil de usar JavaScript Standard Style es instalarlo globalmente como un programa de línea de comandos de Node. Ejecuta el siguiente comando en la terminal: | ||
@@ -125,3 +128,3 @@ ```bash | ||
| Una vez tenga instalado `standard`, ya deberías poder usar `standard`. Un simple caso de uso podría ser chequear estilos de todos los archivos JavaScript en el directorio actual: | ||
| Una vez tenga instalado `standard`, ya deberías poder usar `standard`. Un simple caso de uso podría ser comprobar estilos de todos los archivos JavaScript en el directorio actual: | ||
@@ -142,6 +145,6 @@ ```bash | ||
| **Nota:** Por defecto `standard` buscará todos los archivos que hagan pareo con los patrones: | ||
| **Nota:** Por defecto `standard` buscará todos los archivos que concuerden con los patrones: | ||
| `**/*.js`, `**/*.jsx`. | ||
| ## Lo que podrias hacer si eres inteligente | ||
| ## Lo que podrías hacer si eres inteligente | ||
@@ -162,3 +165,3 @@ 1. Agregar esto `package.json` | ||
| 2. Los estilos son chequeados automaticamente cuando ejecutes `npm test` | ||
| 2. Los estilos son comprobados automáticamente cuando ejecutes `npm test` | ||
@@ -171,5 +174,5 @@ ``` | ||
| 3. No volver a dar feedback de stilos un PR otra vez! | ||
| 3. No vuelvas a dar feedback de estilos en una PR jamás! | ||
| ## ¿Porque deberia usar JavaScript Standard Style? | ||
| ## ¿Por qué deberia usar JavaScript Standard Style? | ||
@@ -179,19 +182,19 @@ La belleza de JavaScript Standard Style es qué es simple. | ||
| de cientos de líneas para cada módulo/proyecto en los que trabajan. | ||
| ¡Es suficiente de esta locura! | ||
| ¡Se acabó esta locura! | ||
| Este modulo te ahorra tiempo a ti (y otros) en tres maneras: | ||
| Este módulo te ahorra tiempo a ti (y otros) en tres maneras: | ||
| - **Sin configuración.** La manera mas fácil de usar estilos consistentes | ||
| en tu proyecto. | ||
| - **Automaticamente formatea el código.** Ejecuta `standard --fix` y dile adios a las | ||
| - **Automáticamente formatea el código.** Ejecuta `standard --fix` y dile adios a las | ||
| inconsistencias en tu código. | ||
| - **De manera temprana captura problemas de estilos y errores de programador.** Te ahorras el tiempo | ||
| - **Captura problemas de estilos y errores del programador muy pronto.** Te ahorras el tiempo | ||
| de hacer revisiones de código eliminando inconsistencias entre el dueño del | ||
| repositorio y los contribuidores. | ||
| Adoptar estilos `standard` significa clasificar la importancia de la claridad del código y las convenciones de la comunidad mucho más que estilo personal. Esto quizás no tenga sentido para el 100% de proyectos y culturas de desarrollo, aunque proyectos de código abierto pueden llegar a ser hostiles para los novatos. Estableciendo expectativas de contribución limpia y automatizada puede hacer el proyecto más saludable. | ||
| Adoptar estilos `standard` significa clasificar la importancia de la claridad del código y las convenciones de la comunidad mucho más que estilo personal. Esto quizás no tenga sentido para el 100% de proyectos y culturas de desarrollo, pero los proyectos de código abierto pueden llegar a ser hostiles para los novatos. Estableciendo expectativas de contribución limpia y automatizada puede hacer el proyecto más saludable. | ||
| ## ¿Quien usa JavaScript Standard Style? | ||
| ## ¿Quién usa JavaScript Standard Style? | ||
| Un monton de gente! | ||
| Un montón de gente! | ||
@@ -216,7 +219,7 @@ [<img width=150 src=https://cdn.rawgit.com/feross/standard/master/docs/logos/npm.png>](https://www.npmjs.com) | [<img width=150 src=https://cdn.rawgit.com/feross/standard/master/docs/logos/github.png>](https://github.com) | [<img width=150 src=https://cdn.rawgit.com/feross/standard/master/docs/logos/opbeat.png>](https://opbeat.com) | [<img width=150 src=https://cdn.rawgit.com/feross/standard/master/docs/logos/nearform.png>](http://www.nearform.com) | [<img width=150 src=https://cdn.rawgit.com/feross/standard/master/docs/logos/brave.png>](https://www.brave.com) | | ||
| Adicionalmente a compañias, muchos miembros de la comunidad usan `standard` en modulos que son | ||
| [muy numerosos](https://raw.githubusercontent.com/feross/standard-packages/master/all.json) para listar aqui. | ||
| Adicionalmente a compañías, muchos miembros de la comunidad usan `standard` en modulos que son | ||
| [muy numerosos](https://raw.githubusercontent.com/feross/standard-packages/master/all.json) para listar aquí. | ||
| También `standard` es el linter con mas estrellas en GitHub | ||
| [Clean Code Linter](https://github.com/showcases/clean-code-linters) un caso. | ||
| También `standard` es el linter con más estrellas en GitHub | ||
| [Clean Code Linter](https://github.com/showcases/clean-code-linters). | ||
@@ -232,3 +235,3 @@ ## ¿Hay plugins para editores de textos? | ||
| Para formateo automatico al guardar, instale **[StandardFormat][sublime-4]**. | ||
| Para formateo automático al guardar, instale **[StandardFormat][sublime-4]**. | ||
@@ -244,3 +247,3 @@ [sublime-1]: https://packagecontrol.io/ | ||
| Para formateo automatico al guardar, instale **[standard-formatter][atom-2]**. Para snippets, | ||
| Para formateo automático al guardar, instale **[standard-formatter][atom-2]**. Para snippets, | ||
| instale **[standardjs-snippets][atom-3]**. | ||
@@ -254,3 +257,3 @@ | ||
| Instale **[vscode-standardjs][vscode-1]**. (Incluye soporte para formateo automatico.) | ||
| Instale **[vscode-standardjs][vscode-1]**. (Incluye soporte para formateo automático.) | ||
@@ -266,3 +269,3 @@ Para snippets JS, instale: **[vscode-standardjs-snippets][vscode-2]**. | ||
| instale **[Syntastic][vim-1]** y agregue esta linea a su `.vimrc`: | ||
| instale **[Syntastic][vim-1]** y agregue esta línea a su `.vimrc`: | ||
@@ -273,3 +276,3 @@ ```vim | ||
| Para formateo automatico al guardar, agregue estas dos linea a su `.vimrc`: | ||
| Para formateo automático al guardar, agregue estas dos líneas a su `.vimrc`: | ||
@@ -301,3 +304,3 @@ ```vim | ||
| Si aun prefieres configurar `standard` manualmente [sigue esta guia](webstorm-2). Esto aplica a todos los productos de JetBrains, incluyendo PhpStorm, IntelliJ, RubyMine y etc. | ||
| Si aun prefieres configurar `standard` manualmente [sigue esta guia](webstorm-2). Esto se aplica a todos los productos de JetBrains, incluyendo PhpStorm, IntelliJ, RubyMine y etc. | ||
@@ -324,5 +327,5 @@ [webstorm-1]: https://www.jetbrains.com/webstorm/ | ||
| ## No estoy de acuerdo con la regla X, ¿lo puedo cambiar? | ||
| ## No estoy de acuerdo con la regla X, ¿la puedo cambiar? | ||
| No. El punto de `standard` es de evitar [bikeshedding][bikeshedding] acerca del estilo. Existen un montón de debates online acerca de tabs vs espacios, etc. que nunca serán resueltos. Estos debates solo distraen de hacer el trabajo. Al final del dia tienes simplemente que “usar alguno”, y esa es toda la filosofía de `standard` -- es un montón de sensibles opiniones de “usar alguno”. Con la esperanza que los usuarios vean el valor en esto más que defender sus propias opiniones. | ||
| No. El objetivo de `standard` es evitar [bikeshedding][bikeshedding] en el estilo. Existen un montón de debates online acerca de tabs vs espacios, etc. que nunca serán resueltos. Estos debates solo te distraen de hacer tu trabajo. Al final del día tienes simplemente que “usar alguno”, y esa es toda la filosofía de `standard` -- es un montón de sensibles opiniones de “usar alguno”. Con la esperanza que los usuarios vean el valor en esto más que defender sus propias opiniones. | ||
@@ -332,3 +335,3 @@ Si realmente quieres configurar cientos de reglas individualmente, puedes usar `eslint` directamente con [eslint-config-standard](https://github.com/feross/eslint-config-standard) aplicando | ||
| Tip: ¡Simplemente usa `standard` y ya esta. Existen problemas reales | ||
| Tip: ¡Simplemente usa `standard` y ya está. Existen problemas reales | ||
| en los cuales debes usar tu tiempo! :P | ||
@@ -340,15 +343,14 @@ | ||
| ¡Por su puesto que no lo es! El estilo aqui no esta afiliado a ningún grupo oficial de estándar web, es por eso que este repositorio se llama `feross/standard` y no `ECMA/standard`. | ||
| ¡Por su puesto que no lo es! Este estilo no está afiliado a ningún grupo oficial de estándar web, por eso este repositorio se llama `feross/standard` y no `ECMA/standard`. | ||
| La palabra “estándar” tiene más significados que solo “estándar web” :-) Por ejemplo: | ||
| - Este módulo ayuda a mantener el código a la más alta *calidad estandar*. | ||
| - Este módulo asegura que las nuevas contribuciones sigan los *estilos estandar* básicos. | ||
| - Este módulo ayuda a mantener el código a la más alta *calidad estándar*. | ||
| - Este módulo asegura que las nuevas contribuciones sigan los *estilos estándar* básicos. | ||
| ## ¿Hay algún formateador automatico? | ||
| ## ¿Hay algún formateador automático? | ||
| ¡Si! Puedes usar `standard --fix` para arreglar la mayoría de problemas automáticamente. | ||
| ¡Sí! Puedes usar `standard --fix` para arreglar la mayoría de problemas automáticamente. | ||
| `standard --fix` esta integrado en `standard` (desde v8.0.0) para máxima conveniencia. | ||
| `standard --fix` está integrado en `standard` (desde v8.0.0) para máxima conveniencia. | ||
| La mayoría de los problemas se arreglan, pero algunos errores (olvidar gestionar errores en callbacks) deben ser arreglados manualmente. | ||
@@ -359,3 +361,3 @@ | ||
| ## ¿Como hago para ignorar archivos? | ||
| ## ¿Cómo hago para ignorar archivos? | ||
@@ -366,3 +368,3 @@ Ciertas rutas (`node_modules/`, `coverage/`, `vendor/`, `*.min.js`, `bundle.js`, y archivos/directorios que empiezan con `.` cómo `.git`) son ignorados automáticamente. | ||
| Algunas veces necesitas ignorar directorios o archivos específicos. Para hacerlo, agrega la propiedad `standard.ignore` al `package.json`: | ||
| A veces necesitas ignorar directorios o archivos específicos. Para hacerlo, agrega la propiedad `standard.ignore` al `package.json`: | ||
@@ -380,7 +382,7 @@ ```json | ||
| ## ¿Como oculto cierta alerta? | ||
| ## ¿Cómo oculto cierta alerta? | ||
| En raros casos, necesitarás romper una regla y ocultar la alerta generada por `standard`. | ||
| JavaScript Standard Style usa [ESLint](http://eslint.org/) bajo la capucha y puedes ocultar las alertas como normalmente lo harias si usaras ESLint directamente. | ||
| JavaScript Standard Style usa [ESLint](http://eslint.org/) bajo la capucha y puedes ocultar las alertas como normalmente lo harías si usaras ESLint directamente. | ||
@@ -417,7 +419,7 @@ Para obtener una salida mas especifica (así puedes encontrar el nombre de la regla a ignorar) ejecute: | ||
| ## Yo uso una librería que contamina el espacio de nombres global. ¿Como puedo evitar los errores "variable is not defined"? | ||
| ## Yo uso una librería que contamina el espacio de nombres global. ¿Cómo puedo evitar los errores "variable is not defined"? | ||
| Algunos paquetes (ej `mocha`) colocan sus funciones (ej: `describe`, `it`) en el objeto global (¡mala manera!). Como estas funciones no están definidas o requeridas (ej: `require`) en ningún lugar del código, `standard` te alertara que están usando una variable que no está definida (usualmente, esta regla es realmente útil para detectar errores de tipeo). Pero queremos inhabilitar estas variables globales. | ||
| Para hacerle a `standard` (como también humanos que leen tu código) saber que ciertas variables son globales en tu código, agregar esto en la parte superior de tu código: | ||
| Para hacerle saber a `standard` (como también a los humanos que leen tu código) que ciertas variables son globales en tu código, agregar esto en la parte superior de tu código: | ||
@@ -447,3 +449,3 @@ ```js | ||
| ## ¿Como Puedo usar características experimentales JavaScript (ES Next)? | ||
| ## ¿Cómo puedo usar características experimentales JavaScript (ES Next)? | ||
@@ -453,5 +455,5 @@ `standard` soporta las ultimas características de ECMAscript, ES8 (ES2017) incluyendo todas las características del lenguaje | ||
| Para soportar características experimentales del lenguaje, `standard` soporta especificando un parser JS customizado. Antes que uses un parser customizado, considera siquiera la complejidad agregada vale la pena. | ||
| Para soportar características experimentales del lenguaje, `standard` soporta especificar un parser JS customizado. Antes de que uses un parser customizado, considera si la complejidad agregada vale la pena. | ||
| Para usar un parser customizado, instálelo desde npm (ejemplo: `npm install babel-eslint`) y ejecute esto: | ||
| Para usar un parser customizado, instálalo desde npm (ejemplo: `npm install babel-eslint`) y ejecuta esto: | ||
@@ -462,3 +464,3 @@ ```bash | ||
| O, agregue esto a `package.json`: | ||
| O, agrega esto a `package.json`: | ||
@@ -473,11 +475,11 @@ ```json | ||
| Si `standard` esta instalado globalmente (ej: `npm install standard --global`), entonces asegurese de instalar `babel-eslint` globalmente también com `npm install babel-eslint --global`. | ||
| Si `standard` está instalado globalmente (ej: `npm install standard --global`), entonces asegúrate de instalar `babel-eslint` globalmente también com `npm install babel-eslint --global`. | ||
| ## ¿Puedo usar una variación de lenguaje JavaScript, como Flow? | ||
| Antes de usar una variable del lenguaje JavaScript customizado, considere si la complejidad agregada | ||
| Antes de usar una variable del lenguaje JavaScript customizado, considera si la complejidad agregada | ||
| (y esfuerzo requerido para obtener los contribuidores alcanzarle con rapidez) vale la pena. | ||
| `standard` soporta plugins ESLint. Usa uno de estos para transformar el código a javascript válido antes de que `standard` lo vea. Para usar un parser customizado, instálelo desde | ||
| npm (example: `npm install eslint-plugin-flowtype`) y ejecute: | ||
| `standard` soporta plugins ESLint. Usa uno de estos para transformar el código a javascript válido antes de que `standard` lo vea. Para usar un parser customizado, instálalo desde | ||
| npm (example: `npm install eslint-plugin-flowtype`) y ejecuta: | ||
@@ -488,3 +490,3 @@ ```bash | ||
| O, agrege esto a `package.json`: | ||
| O, agrega esto a `package.json`: | ||
@@ -502,9 +504,9 @@ ```json | ||
| Si `standard` esta instalado globalmente (ej: `npm install standard --global`), entonces asegurese d instalar `eslint-plugin-flowtype` globalmente también, con `npm install eslint-plugin-flowtype -g`. | ||
| Si `standard` está instalado globalmente (ej: `npm install standard --global`), entonces asegúrate de instalar `eslint-plugin-flowtype` globalmente también, con `npm install eslint-plugin-flowtype -g`. | ||
| *Nota: `plugin` y `plugins` son equivalentes* | ||
| ## ¿Que acerca de Mocha, Jasmine, QUnit y etc? | ||
| ## ¿Qué pasa con Mocha, Jasmine, QUnit y etc? | ||
| Para soportar mocha in tus archivos de prueba, agrega esto al inicio de los archivos: | ||
| Para soportar mocha en tus archivos de tests, agrega esto al inicio de los archivos: | ||
@@ -515,3 +517,3 @@ ```js | ||
| O, ejecute: | ||
| O, ejecuta: | ||
@@ -522,9 +524,9 @@ ```bash | ||
| Donde `mocha` puede ser uno de `jasmine`, `qunit`, `phantomjs`, y asi sucesivamente. | ||
| Para ver la lista completa, chequear la documentación de ESLint [especificando entornos](http://eslint.org/docs/user-guide/configuring.html#specifying-environments). | ||
| Por una lista de qué variables globales están disponibles en estos entornos chequea el modulo npm [globals](https://github.com/sindresorhus/globals/blob/master/globals.json) npm | ||
| Donde `mocha` puede ser `jasmine`, `qunit`, `phantomjs`, y así sucesivamente. | ||
| Para ver la lista completa, comprueba la documentación de ESLint [especificando entornos](http://eslint.org/docs/user-guide/configuring.html#specifying-environments). | ||
| Para una lista de qué variables globales están disponibles en estos entornos comprueba el módulo npm [globals](https://github.com/sindresorhus/globals/blob/master/globals.json). | ||
| *Nota: `env` y `envs` son equivalentes* | ||
| ## ¿Que acerca de Web Workers? | ||
| ## ¿Qué pasa con Web Workers? | ||
@@ -537,6 +539,6 @@ Agrega esto al inicio de tus archivos: | ||
| Esto le hara saber a` standard` (como también humanos que leen tu código) que | ||
| Esto le hará saber a` standard` (como también humanos que leen tu código) que | ||
| `self` es una variable global en el codigo web worker. | ||
| ## ¿Puedo verificar codigo dentro de archivos Markdown o HTML? | ||
| ## ¿Puedo verificar código dentro de archivos Markdown o HTML? | ||
@@ -548,3 +550,3 @@ Para verificar código dentro de archivos Markdown use [`standard-markdown`](https://www.npmjs.com/package/standard-markdown). | ||
| Para verificar código dentro de archivos Markdown, use el plugin ESLint: | ||
| Para verificar código dentro de archivos Markdown, usa el plugin ESLint: | ||
@@ -555,3 +557,3 @@ ```bash | ||
| Luego para verificar codigo JS que aparece dentro de bloques código, ejecute: | ||
| Luego para verificar código JS que aparece dentro de bloques código, ejecute: | ||
@@ -576,3 +578,3 @@ ```bash | ||
| Funny you should ask! | ||
| ¡Qué bien que lo preguntes! | ||
@@ -587,3 +589,3 @@ ```sh | ||
| ## ¿Como hago la salida (output) todo colorido y *bonito*? | ||
| ## ¿Cómo hago la salida (output) toda colorida y *bonita*? | ||
@@ -602,3 +604,3 @@ La salida integrada es simple y directa, pero si te gustan las cosas brillantes, puedes instalar [snazzy](https://www.npmjs.com/package/snazzy): | ||
| También esta [standard-tap](https://www.npmjs.com/package/standard-tap), | ||
| También tienes [standard-tap](https://www.npmjs.com/package/standard-tap), | ||
| [standard-json](https://www.npmjs.com/package/standard-json), | ||
@@ -646,3 +648,3 @@ [standard-reporter](https://www.npmjs.com/package/standard-reporter), y | ||
| Hacer Lint a los archivos que hagan pareo con el patrón globs. | ||
| Hacer Lint a los archivos que concuerden con el patrón globs. | ||
| Un objeto `opts` puede ser proporcionado: | ||
@@ -664,5 +666,5 @@ | ||
| ## ¿Como puedo contribuir a `standard`? | ||
| ## ¿Cómo puedo contribuir a `standard`? | ||
| Contribuciones son bienvenidas! Chequea los [issues](https://github.com/feross/standard/issues) o [PRs](https://github.com/feross/standard/pulls), o has el tuyo propio si quieres algo que nos ves allí | ||
| Las contribuciones son bienvenidas! Comprueba los [issues](https://github.com/feross/standard/issues) o [PRs](https://github.com/feross/standard/pulls), o haz el tuyo propio si quieres algo que nos ves allí | ||
@@ -681,3 +683,3 @@ Unete a nosotros `#standard` en freenode. | ||
| También hay un monton **[plugins editores de textos](#plugins-editores-de-textos)**, una lista de | ||
| También hay un montón **[plugins editores de textos](#plugins-editores-de-textos)**, una lista de | ||
| **[paquetes npm que usan `standard`](https://github.com/feross/standard-packages)**, | ||
@@ -684,0 +686,0 @@ y una impresionante lista de |
@@ -22,3 +22,4 @@ <h1 align="center"> | ||
| <a href="README-esla.md">Spanish</a>, | ||
| <a href="README-zhtw.md">繁體中文</a> | ||
| <a href="README-zhtw.md">繁體中文</a>, | ||
| <a href="README-zhcn.md">简体中文</a> | ||
| </p> | ||
@@ -25,0 +26,0 @@ |
@@ -20,5 +20,6 @@ <h1 align="center"> | ||
| 翻譯： | ||
| <a href="../README.md">English</a>、 | ||
| <a href="README-ptbr.md">Português</a>、 | ||
| <a href="README-esla.md">Spanish</a> | ||
| <a href="../README.md">English</a>, | ||
| <a href="README-ptbr.md">Português</a>, | ||
| <a href="README-esla.md">Spanish</a>, | ||
| <a href="README-zhcn.md">简体中文</a> | ||
| </p> | ||
@@ -25,0 +26,0 @@ |
@@ -13,3 +13,3 @@ # JavaScript Standard Style | ||
| * **使用两个空格** 进行缩进。 | ||
| * **使用两个空格**进行缩进。 | ||
@@ -33,3 +33,3 @@ eslint: [`indent`](http://eslint.org/docs/rules/indent) | ||
| * **不要留下未使用的变量**。 | ||
| * **不要定义未使用的变量**。 | ||
@@ -80,3 +80,3 @@ eslint: [`no-unused-vars`](http://eslint.org/docs/rules/no-unused-vars) | ||
| * **字符串拼接操作符（Infix operators）**之间要留空格。 | ||
| * **字符串拼接操作符 (Infix operators)** 之间要留空格。 | ||
@@ -136,3 +136,3 @@ eslint: [`space-infix-ops`](http://eslint.org/docs/rules/space-infix-ops) | ||
| * **多行 if 语句的** 的括号不能省。 | ||
| * **多行 if 语句的**的括号不能省。 | ||
@@ -177,3 +177,3 @@ eslint: [`curly`](http://eslint.org/docs/rules/curly) | ||
| * **使用浏览器全局变量时加上**`window.`前缀。<br> | ||
| * **使用浏览器全局变量时加上** `window.` 前缀。<br> | ||
| Exceptions are: `document`, `console` and `navigator`. | ||
@@ -187,3 +187,3 @@ | ||
| * **不允许有连续多行的空行**。 | ||
| * **不允许有连续多行空行**。 | ||
@@ -206,3 +206,3 @@ eslint: [`no-multiple-empty-lines`](http://eslint.org/docs/rules/no-multiple-empty-lines) | ||
| * **对于三元运算符** 操持`?`和`:`与他们所负责的代码处于同一行 | ||
| * **对于三元运算符** `?` 和 `:` 与他们所负责的代码处于同一行 | ||
@@ -306,3 +306,3 @@ eslint: [`operator-linebreak`](http://eslint.org/docs/rules/operator-linebreak) | ||
| * **点号操作符须与属性处在同一行**。 | ||
| * **点号操作符须与属性需在同一行**。 | ||
@@ -496,3 +496,3 @@ eslint: [`dot-location`](http://eslint.org/docs/rules/dot-location) | ||
| * **不要定义重复的函数参数**。 | ||
| * **不要定义冗余的函数参数**。 | ||
@@ -511,3 +511,3 @@ eslint: [`no-dupe-args`](http://eslint.org/docs/rules/no-dupe-args) | ||
| * **类中不要定义重复的属性**。 | ||
| * **类中不要定义冗余的属性**。 | ||
@@ -534,3 +534,3 @@ eslint: [`no-dupe-class-members`](http://eslint.org/docs/rules/no-dupe-class-members) | ||
| * **`switch` 语句中不要定义重复的 `case`**。 | ||
| * **`switch` 语句中不要定义重复的 `case` 分支**。 | ||
@@ -611,3 +611,3 @@ eslint: [`no-duplicate-case`](http://eslint.org/docs/rules/no-duplicate-case) | ||
| * **譬如多余的函数上下文绑定**。 | ||
| * **避免多余的函数上下文绑定**。 | ||
@@ -689,3 +689,3 @@ eslint: [`no-extra-bind`](http://eslint.org/docs/rules/no-extra-bind) | ||
| * **譬如对声明过的函数重新赋值**。 | ||
| * **避免对声明过的函数重新赋值**。 | ||
@@ -707,3 +707,3 @@ eslint: [`no-func-assign`](http://eslint.org/docs/rules/no-func-assign) | ||
| * **不要使用隐式的`eval()`**。 | ||
| * **注意隐式的 `eval()`**。 | ||
@@ -727,3 +727,3 @@ eslint: [`no-implied-eval`](http://eslint.org/docs/rules/no-implied-eval) | ||
| * **不要向 `RegExp` 的构造器传入非法的正则表达式**。 | ||
| * **不要向 `RegExp` 构造器传入非法的正则表达式**。 | ||
@@ -995,3 +995,3 @@ eslint: [`no-invalid-regexp`](http://eslint.org/docs/rules/no-invalid-regexp) | ||
| * **类中，使用 `this` 前请确保 `super()` 已调用**。 | ||
| * **使用 `this` 前请确保 `super()` 已调用**。 | ||
@@ -1009,3 +1009,3 @@ eslint: [`no-this-before-super`](http://eslint.org/docs/rules/no-this-before-super) | ||
| * **用`throw`抛错时，抛出 `Error` 对象而不是字符串**。 | ||
| * **用 `throw` 抛错时，抛出 `Error` 对象而不是字符串**。 | ||
@@ -1052,3 +1052,3 @@ eslint: [`no-throw-literal`](http://eslint.org/docs/rules/no-throw-literal) | ||
| * **`return`，`throw`，`continue` 和 `break` 这些语句后面的代码都是多余的**。 | ||
| * **`return`，`throw`，`continue` 和 `break` 后不要再跟代码**。 | ||
@@ -1064,3 +1064,3 @@ eslint: [`no-unreachable`](http://eslint.org/docs/rules/no-unreachable) | ||
| * **`finally` 代码块中不要再程序流程**。 | ||
| * **`finally` 代码块中不要再改变程序执行流程**。 | ||
@@ -1095,3 +1095,3 @@ eslint: [`no-unsafe-finally`](http://eslint.org/docs/rules/no-unsafe-finally) | ||
| * **避免使用不必要的动态计算值作对象属性**。 | ||
| * **避免使用不必要的计算值作对象属性**。 | ||
@@ -1194,3 +1194,3 @@ eslint: [`no-useless-computed-key`](http://eslint.org/docs/rules/no-useless-computed-key) | ||
| * **分号前面不留空格，后面留空格**。 | ||
| * **遇到分号时空格要后留前不留**。 | ||
@@ -1204,3 +1204,3 @@ eslint: [`semi-spacing`](http://eslint.org/docs/rules/semi-spacing) | ||
| * **代码块开始之间留一个空格**。 | ||
| * **代码块首尾留空格**。 | ||
@@ -1232,3 +1232,3 @@ eslint: [`space-before-blocks`](http://eslint.org/docs/rules/space-before-blocks) | ||
| * **注释前后留空格**。 | ||
| * **注释首尾留空格**。 | ||
@@ -1272,3 +1272,3 @@ eslint: [`spaced-comment`](http://eslint.org/docs/rules/spaced-comment) | ||
| * **自调用匿名函数 (IIFEs) 需要使用括号包裹**。 | ||
| * **自调用匿名函数 (IIFEs) 使用括号包裹**。 | ||
@@ -1347,4 +1347,2 @@ eslint: [`wrap-iife`](http://eslint.org/docs/rules/wrap-iife) | ||
| Clever short-hands are discouraged, in favor of clear and readable expressions, whenever | ||
| possible. | ||
| 相比更加可读易懂的代码，那些看似投巧的写法是不可取的。 | ||
@@ -1371,15 +1369,13 @@ | ||
| ##### 一些相关视频： | ||
| ##### 一个值得观看的视频： | ||
| - [Are Semicolons Necessary in JavaScript? - YouTube][3] | ||
| - [JavaScript 中的分号多余吗？- YouTube][3] | ||
| All popular code minifiers in use today use AST-based minification, so they can | ||
| handle semicolon-less JavaScript with no issues (since semicolons are not required | ||
| in JavaScript). | ||
| 当前主流的代码压缩方案都是基于词法（AST-based）进行的，所以在处理无分号的代码时完全没有压力（何况 JavaScript 中分号本来就不是强制的）。 | ||
| ##### 一段摘抄自 *["An Open Letter to JavaScript Leaders Regarding Semicolons"][1]* 一书的内容： | ||
| ##### 一段摘抄自 *["An Open Letter to JavaScript Leaders Regarding Semicolons"][1]* 这篇文章的内容： | ||
| > [自动化插入分号的做法]是安全可依赖的，而且其产出的代码能够在所有浏览器里很好地运行。 Closure compiler, yuicompressor, packer 还有 jsmin 都能正确地对这样的代码进行压缩处理。并没有任何性能相关的问题。 | ||
| > | ||
| > 不得不说，Javascript 社区里的大牛们一直是错误的，并不能教给你最佳实践。真是让人忧伤啊。 我建议先弄清楚 JS 是怎样断句的（如此地方双是看起来断了其实并没有），明白了这个后就可以随心写出漂亮的代码了。 | ||
| > 不得不说，Javascript 社区里的大牛们一直是错误的，并不能教给你最佳实践。真是让人忧伤啊。 我建议先弄清楚 JS 是怎样断句的（还有就是哪些地方看起来断了其实并没有），明白了这个后就可以随心写出漂亮的代码了。 | ||
| > | ||
@@ -1396,3 +1392,3 @@ > 一般来说， `\n` 表示语句结束，除非： | ||
| > | ||
| > 第三条也容易理解。 `if (x)\ny()` is equivalent to `if (x) { y() }`. 解释器向下寻找到代码块或一条语句为止。 | ||
| > 第三条也容易理解。 `if (x)\ny()` 等价于 `if (x) { y() }`。解释器会向下寻找到代码块或一条语句为止。 | ||
| > | ||
@@ -1399,0 +1395,0 @@ > `;` 是条合法的 JavaScript 语句。所以 `if(x);` 等价于 `if(x){}`，表示 “如果 x 为真，什么也不做。” 这种写法在循环里面可以看到，就是当条件判断与条件更新是同一个方法的时候。 不常见，但也不至于没听说过吧。 |
| { | ||
| "name": "standard", | ||
| "description": "JavaScript Standard Style", | ||
| "version": "10.0.1", | ||
| "version": "10.0.2", | ||
| "author": { | ||
@@ -16,3 +16,3 @@ "email": "feross@feross.org", | ||
| "eslint": "~3.19.0", | ||
| "eslint-config-standard": "10.2.0", | ||
| "eslint-config-standard": "10.2.1", | ||
| "eslint-config-standard-jsx": "4.0.1", | ||
@@ -19,0 +19,0 @@ "eslint-plugin-import": "~2.2.0", |
@@ -22,3 +22,4 @@ <h1 align="center"> | ||
| <a href="docs/README-esla.md">Spanish</a>, | ||
| <a href="docs/README-zhtw.md">繁體中文</a> | ||
| <a href="docs/README-zhtw.md">繁體中文</a>, | ||
| <a href="docs/README-zhcn.md">简体中文</a> | ||
| </p> | ||
@@ -261,8 +262,4 @@ | ||
| Install **[Syntastic][vim-1]** and add this line to `.vimrc`: | ||
| Install **[ale][vim-1]**. | ||
| ```vim | ||
| let g:syntastic_javascript_checkers = ['standard'] | ||
| ``` | ||
| For automatic formatting on save, add these lines to `.vimrc`: | ||
@@ -275,4 +272,8 @@ | ||
| [vim-1]: https://github.com/scrooloose/syntastic | ||
| Alternative plugins to consider include [neomake][vim-2] and [syntastic][vim-3], both of which have built-in support for `standard` (though configuration may be necessary). | ||
| [vim-1]: https://github.com/w0rp/ale | ||
| [vim-2]: https://github.com/neomake/neomake | ||
| [vim-3]: https://github.com/vim-syntastic/syntastic | ||
| ### Emacs | ||
@@ -491,6 +492,6 @@ | ||
| valid JavaScript before `standard` sees it. To use a custom parser, install it from | ||
| npm (example: `npm install eslint-plugin-flowtype`) and run: | ||
| npm and run: | ||
| ```bash | ||
| $ standard --plugin flowtype | ||
| $ standard --plugin PLUGIN_NAME | ||
| ``` | ||
@@ -503,3 +504,3 @@ | ||
| "standard": { | ||
| "plugins": [ "flowtype" ] | ||
| "plugins": [ "PLUGIN_NAME" ] | ||
| } | ||
@@ -509,5 +510,23 @@ } | ||
| To use Flow, you need to use `babel-eslint` as your parser. So, run | ||
| `npm install eslint-plugin-flowtype babel-eslint`, then run: | ||
| ```bash | ||
| $ standard --plugin flowtype --parser babel-eslint | ||
| ``` | ||
| Or, add this to `package.json`: | ||
| ```json | ||
| { | ||
| "standard": { | ||
| "plugins": [ "flowtype" ], | ||
| "parser": "babel-eslint" | ||
| } | ||
| } | ||
| ``` | ||
| If `standard` is installed globally (i.e. `npm install standard --global`), then | ||
| be sure to install `eslint-plugin-flowtype` globally as well, with | ||
| `npm install eslint-plugin-flowtype -g`. | ||
| `npm install eslint-plugin-flowtype --global`. | ||
@@ -514,0 +533,0 @@ *Note: `plugin` and `plugins` are equivalent.* |
New alerts
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
Fixed alerts
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
Improved metrics
- Total package byte prevSize
- increased by9.75%
312915
- Number of package files
- increased by5.26%
20
- Number of lines in readme file
- increased by2.71%
720
Dependency changes
+ Addedeslint-config-standard@10.2.1(transitive)
- Removedeslint-config-standard@10.2.0(transitive)