diff --git a/packages/tsconfig-reference/copy/es/categories/Additional_Checks_6176.md b/packages/tsconfig-reference/copy/es/categories/Additional_Checks_6176.md new file mode 100644 index 000000000000..84d65c80fe6c --- /dev/null +++ b/packages/tsconfig-reference/copy/es/categories/Additional_Checks_6176.md @@ -0,0 +1,5 @@ +--- +display: "Comprobaciones del Linter" +--- + +Una colección de comprobaciones extras, que de alguna manera cruzan los límites del compilador contra el linter. Puede que prefieras usar una herramienta como eslint sobre estas opciones si buscas reglas más completas. diff --git a/packages/tsconfig-reference/copy/es/categories/Advanced_Options_6178.md b/packages/tsconfig-reference/copy/es/categories/Advanced_Options_6178.md new file mode 100644 index 000000000000..d0d4f0d6c4a2 --- /dev/null +++ b/packages/tsconfig-reference/copy/es/categories/Advanced_Options_6178.md @@ -0,0 +1,5 @@ +--- +display: "Avanzado" +--- + +Opciones que ayudan a la depuración diff --git a/packages/tsconfig-reference/copy/es/categories/Basic_Options_6172.md b/packages/tsconfig-reference/copy/es/categories/Basic_Options_6172.md new file mode 100644 index 000000000000..34f474596412 --- /dev/null +++ b/packages/tsconfig-reference/copy/es/categories/Basic_Options_6172.md @@ -0,0 +1,5 @@ +--- +display: "Opciones del Proyecto" +--- + +Estos ajustes se utilizan para definir las expectativas de tiempo de ejecución de su proyecto, cómo y dónde quiere que se emita el código JavaScript y el nivel de integración que desea con el código JavaScript existente. diff --git a/packages/tsconfig-reference/copy/es/categories/Command_line_Options_6171.md b/packages/tsconfig-reference/copy/es/categories/Command_line_Options_6171.md new file mode 100644 index 000000000000..9cfc401f2f07 --- /dev/null +++ b/packages/tsconfig-reference/copy/es/categories/Command_line_Options_6171.md @@ -0,0 +1,3 @@ +--- +display: "Línea de comando" +--- diff --git a/packages/tsconfig-reference/copy/es/categories/Experimental_Options_6177.md b/packages/tsconfig-reference/copy/es/categories/Experimental_Options_6177.md new file mode 100644 index 000000000000..c043fba9a04f --- /dev/null +++ b/packages/tsconfig-reference/copy/es/categories/Experimental_Options_6177.md @@ -0,0 +1,8 @@ +--- +display: "Experimental" +--- + +TypeScript se esfuerza por incluir sólo las características confirmadas para ser añadidas en el lenguaje JavaScript. + +Ha habido casos en los que una característica es lo suficientemente convincente como para ser una excepción a esa regla, y estos viven como opciones de compilación experimentales. +Es posible que una versión de estas características sea diferente a cuando se añaden al lenguaje JavaScript, y por lo tanto se consideran arriesgadas. diff --git a/packages/tsconfig-reference/copy/es/categories/Module_Resolution_Options_6174.md b/packages/tsconfig-reference/copy/es/categories/Module_Resolution_Options_6174.md new file mode 100644 index 000000000000..eea5f870ae49 --- /dev/null +++ b/packages/tsconfig-reference/copy/es/categories/Module_Resolution_Options_6174.md @@ -0,0 +1,3 @@ +--- +display: "Resolución de Módulos" +--- diff --git a/packages/tsconfig-reference/copy/es/categories/Project_Files_0.md b/packages/tsconfig-reference/copy/es/categories/Project_Files_0.md new file mode 100644 index 000000000000..cc63211591ad --- /dev/null +++ b/packages/tsconfig-reference/copy/es/categories/Project_Files_0.md @@ -0,0 +1,5 @@ +--- +display: "Inclusión de archivos" +--- + +Estos ajustes te ayudan a asegurarte que TypeScript elija los archivos correctos. diff --git a/packages/tsconfig-reference/copy/es/categories/Source_Map_Options_6175.md b/packages/tsconfig-reference/copy/es/categories/Source_Map_Options_6175.md new file mode 100644 index 000000000000..9931798bde92 --- /dev/null +++ b/packages/tsconfig-reference/copy/es/categories/Source_Map_Options_6175.md @@ -0,0 +1,7 @@ +--- +display: "Mapas de Fuentes o 'Source Maps'" +--- + +Con el fin de proporcionar herramientas de depuración e informes de fallos que tengan sentido para los desarrolladores, TypeScript soporta la emisión de archivos adicionales que se ajustan a los estándares del Mapa de Fuentes de JavaScript. + +Estos son emitidos como archivos `.map` que se localizan junto al archivo que representan. diff --git a/packages/tsconfig-reference/copy/es/categories/Strict_Type_Checking_Options_6173.md b/packages/tsconfig-reference/copy/es/categories/Strict_Type_Checking_Options_6173.md new file mode 100644 index 000000000000..5c6b37147503 --- /dev/null +++ b/packages/tsconfig-reference/copy/es/categories/Strict_Type_Checking_Options_6173.md @@ -0,0 +1,15 @@ +--- +display: "Comprobaciones Estrictas" +--- + +Recomendamos usar la opción de [compilador `strict`](#strict) para optar por todas las mejoras posibles disponibles en el desarrollo. + +TypeScript soporta un amplio espectro de patrones de JavaScript y permite por defecto bastante flexibilidad para acomodar estos estilos. +A menudo la seguridad y la potencial escalabilidad de una base de código puede estar en desacuerdo con algunas de estas técnicas. + +Debido a la variedad de JavaScript soportado, la actualización a una nueva versión de TypeScript puede descubrir dos tipos de errores: + +- Errores que ya existen en su base de código, que TypeScript ha descubierto porque el lenguaje ha refinado su comprensión de JavaScript. +- Un nuevo conjunto de errores que abordan un nuevo dominio de problemas. + +TypeScript normalmente añadirá un indicador de compilación para este último conjunto de errores, y por defecto estos no están habilitados. diff --git a/packages/tsconfig-reference/copy/es/categories/Watch_Options_999.md b/packages/tsconfig-reference/copy/es/categories/Watch_Options_999.md new file mode 100644 index 000000000000..73b4d895ac00 --- /dev/null +++ b/packages/tsconfig-reference/copy/es/categories/Watch_Options_999.md @@ -0,0 +1,10 @@ +--- +display: "Opciones de Vigilancia" +--- + +TypeScript 3.8 lanzó una nueva estrategia para analizar los directorios, que es crucial para detectar eficientemente los cambios en los `node_modules`. + +En sistemas operativos como Linux, TypeScript instala vigilantes de directorios (a diferencia de vigilantes de archivos) en `node_modules` y muchos de sus subdirectorios para detectar cambios en las dependencias. +Esto se debe a que el número de vigilantes de archivos disponibles es a menudo eclipsado por el de archivos en `node_modules`, mientras que hay muchos menos directorios que rastrear. + +Debido a que cada proyecto podría funcionar mejor bajo diferentes estrategias, y este nuevo enfoque podría no funcionar bien para sus flujos de trabajo, TypeScript 3.8 introduce un nuevo campo `watchOptions` que permite a los usuarios indicar al compilador/servicio lingüístico qué estrategias de vigilancia deben ser utilizadas para mantener el seguimiento de los archivos y directorios. diff --git a/packages/tsconfig-reference/copy/es/intro.md b/packages/tsconfig-reference/copy/es/intro.md new file mode 100644 index 000000000000..136cac0c6864 --- /dev/null +++ b/packages/tsconfig-reference/copy/es/intro.md @@ -0,0 +1,5 @@ +## Introducción a la referencia TSConfig + +Un archivo TSConfig en un directorio indica que ese directorio es la raiz de un proyecto TypeScript or JavaScript. El archivo TSConfig puede ser tanto `tsconfig.json` o `jsconfig.json`, teniendo ambos el mismo comportamiento y el mismo conjunto de variables de configuración. + +Esta página cubre todas las diferentes opciones disponibles dentro de un archivo TSConfig. Comienza con una visión general de cada opción, luego se mueve a los atributos raíz en el archivo JSON, luego a las opciones de compilación `compilerOptions` que son el grueso principal y termina con las opciones de vigilancia `watchOptions`. diff --git a/packages/tsconfig-reference/copy/es/options/allowJs.md b/packages/tsconfig-reference/copy/es/options/allowJs.md new file mode 100644 index 000000000000..707f9cf58202 --- /dev/null +++ b/packages/tsconfig-reference/copy/es/options/allowJs.md @@ -0,0 +1,39 @@ +--- +display: "Permitir JS" +oneline: "Permite incluir archivos .JS en las importaciones de archivos TypeScript." +--- + +Permite importar archivos JavaScript dentro de su proyecto, en lugar de sólo los archivos `.ts` y `.tsx`. Por ejemplo, este archivo JavaScript: + +```js twoslash +// @filename: card.js +export const defaultCardDeck = "Heart"; +``` + +Al ser importado en un archivo de TypeScript se producirá un error: + +```ts twoslash +// @errors: 2307 +// @filename: card.js +module.exports.defaultCardDeck = "Heart"; +// ---cut--- +// @filename: index.ts +import { defaultCardDeck } from "./card"; + +console.log(defaultCardDeck); +``` + +Se importa sin problemas cuando se habilita la opción `allowJs` + +```ts twoslash +// @filename: card.js +module.exports.defaultCardDeck = "Heart"; +// ---cut--- +// @allowJs +// @filename: index.ts +import { defaultCardDeck } from "./card"; + +console.log(defaultCardDeck); +``` + +Esta opción puede ser usada como una forma de agregar progresivamente archivos TypeScript en un proyecto JavaScript al permitir los archivos con extensión `.ts` y `.tsx` convivir con los archivos JavaScript existentes. diff --git a/packages/tsconfig-reference/copy/es/options/allowSyntheticDefaultImports.md b/packages/tsconfig-reference/copy/es/options/allowSyntheticDefaultImports.md new file mode 100644 index 000000000000..f153c24ebb1f --- /dev/null +++ b/packages/tsconfig-reference/copy/es/options/allowSyntheticDefaultImports.md @@ -0,0 +1,21 @@ +--- +display: "Permitir las importaciones sintéticas por defecto" +oneline: "Permite 'import x from y' cuando un módulo no tiene una exportación por defecto" +--- + +Cuando está activo, `allowSyntheticDefaultImports` le permite escribir una importación de la siguiente forma: + +```ts +import React from "react"; +``` + +en vez de: + +```ts +import * as React from "react"; +``` + +Cuando el módulo **NO** contiene una exportación por defecto. + +Esto no afecta al JavaScript emitido por TypeScript, sólo para la comprobación de tipos. +Esta opción ajusta el comportamiento de TypeScript en línea con Babel, donde se emite código extra para hacer más cómoda el uso de una exportación por defecto de un módulo. diff --git a/packages/tsconfig-reference/copy/es/options/allowUmdGlobalAccess.md b/packages/tsconfig-reference/copy/es/options/allowUmdGlobalAccess.md new file mode 100644 index 000000000000..82f8ff2ae59e --- /dev/null +++ b/packages/tsconfig-reference/copy/es/options/allowUmdGlobalAccess.md @@ -0,0 +1,8 @@ +--- +display: "Permitir el acceso global a UMD" +oneline: "Asume todas las importaciones UMD como disponibles globalmente" +--- + +Cuando está activo, `allowUmdGlobalAccess` le permite acceder a las exportaciones UMD como si fueran globales dentro de los archivos del módulo. Un módulo es un archivo que tiene importaciones y/o exportaciones. Sin esta opción, el usar una exportación proveniente de un módulo UMD requerirá una declaración de tipo importación. + +Un ejemplo de caso de uso de esta opción sería un proyecto web donde se sabe que la biblioteca particular (como jQuery o Lodash) siempre estará disponible en tiempo de ejecución, pero no puedes acceder a esta con una importación. diff --git a/packages/tsconfig-reference/copy/es/options/allowUnreachableCode.md b/packages/tsconfig-reference/copy/es/options/allowUnreachableCode.md new file mode 100644 index 000000000000..7e7cd6fcf2d7 --- /dev/null +++ b/packages/tsconfig-reference/copy/es/options/allowUnreachableCode.md @@ -0,0 +1,40 @@ +--- +display: "Permitir código inalcanzable" +oneline: "Muestra un error cuando el código nunca será ejecutado" +--- + +Cuando: + +- `undefined` (por defecto) proporciona sugerencias como advertencias a los editores +- `true` código inalcanzable es ignorado +- `false` genera errores de compilación cuando se detecta código inalcanzable + +Estas advertencias son sólo sobre el código que es evidentemente inalcanzable debido al uso de la sintaxis de JavaScript, por ejemplo: + +```ts +function fn(n: number) { + if (n > 5) { + return true; + } else { + return false; + } + return true; +} +``` + +Con la opción `"allowUnreachableCode": false`: + +```ts twoslash +// @errors: 7027 +// @allowUnreachableCode: false +function fn(n: number) { + if (n > 5) { + return true; + } else { + return false; + } + return true; +} +``` + +Esto no afecta a los errores sobre la base del código que _parece_ ser inalcanzable debido al análisis de tipos. diff --git a/packages/tsconfig-reference/copy/es/options/allowUnusedLabels.md b/packages/tsconfig-reference/copy/es/options/allowUnusedLabels.md new file mode 100644 index 000000000000..92eb916de92f --- /dev/null +++ b/packages/tsconfig-reference/copy/es/options/allowUnusedLabels.md @@ -0,0 +1,19 @@ +--- +display: "Permite notaciones sin utilizar" +oneline: "Muestra un error cuando accidentalmente se crea una notación" +--- + +Al configurarse como falsa, deshabilita las advertencias acerca de notaciones sin usar. + +Las notaciones son muy raras en JavaScript y tipicamente indican un intento por escribir un objeto literal: + +```ts twoslash +// @errors: 7028 +// @allowUnusedLabels: false +function verifyAge(age: number) { + // Forgot 'return' statement + if (age > 18) { + verified: true; + } +} +``` diff --git a/packages/tsconfig-reference/copy/es/options/alwaysStrict.md b/packages/tsconfig-reference/copy/es/options/alwaysStrict.md new file mode 100644 index 000000000000..5bb1196c8006 --- /dev/null +++ b/packages/tsconfig-reference/copy/es/options/alwaysStrict.md @@ -0,0 +1,8 @@ +--- +display: "Siempre estricto" +oneline: "Asegura que 'use strict' siempre sea emitido" +--- + +Asegura que sus archivos son analizados en el modo estricto de ECMAScript, y emite "use strict" para cada archivo fuente. + +El modo [estricto de ECMAScript](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Strict_mode) fue introducido en ES5 y y proporciona ajustes de comportamiento en el tiempo de ejecución del motor de JavaScript para mejorar el rendimiento, y hace que un conjunto de errores se lancen en lugar de ignorarlos silenciosamente. diff --git a/packages/tsconfig-reference/copy/es/options/assumeChangesOnlyAffectDirectDependencies.md b/packages/tsconfig-reference/copy/es/options/assumeChangesOnlyAffectDirectDependencies.md new file mode 100644 index 000000000000..e69988039a7f --- /dev/null +++ b/packages/tsconfig-reference/copy/es/options/assumeChangesOnlyAffectDirectDependencies.md @@ -0,0 +1,8 @@ +--- +display: "Asume que los cambios sólo afectan a las dependencias directas" +oneline: "Una opción de modo de vigilancia drásticamente más rápida, pero ocasionalmente inexacta." +--- + +Cuando esta opción se encuentra activa, TypeScript evitará volver a comprobar/reconstruir todos los archivos verdaderamente afectados, y sólo volverá a comprobar/reconstruir los archivos que han cambiado, así como los archivos que los importan directamente. + +Esto puede considerarse una implementación 'rápida y suelta' del algoritmo de vigilancia, que puede reducir drásticamente los tiempos de reconstrucción incremental a expensas de tener que ejecutar la construcción completa ocasionalmente para obtener todos los mensajes de error del compilador. diff --git a/packages/tsconfig-reference/copy/es/options/baseUrl.md b/packages/tsconfig-reference/copy/es/options/baseUrl.md new file mode 100644 index 000000000000..8698037b2285 --- /dev/null +++ b/packages/tsconfig-reference/copy/es/options/baseUrl.md @@ -0,0 +1,26 @@ +--- +display: "URL Base" +oneline: "Configura una URL base para los nombres de los módulos relativos" +--- + +Le permite establecer un directorio base para resolver nombres de módulos no absolutos. + +Puede definir una carpeta raíz donde puede hacer la resolución absoluta de los archivos. Por ejemplo: + +``` +baseUrl +├── ex.ts +├── hello +│ └── world.ts +└── tsconfig.json +``` + +Con `"baseUrl": "./"` dentro de este proyecto, TypeScript TypeScript buscará los archivos que empiezan en la misma carpeta que el archivo `tsconfig.json`. + +```ts +import { helloWorld } from "hello/world"; + +console.log(helloWorld); +``` + +Si te cansas de que las importaciones siempre se vean como `"../"` o `"./"`. o que necesiten cambiarse al mover los archivos, esta es una gran manera de arreglar eso. diff --git a/packages/tsconfig-reference/copy/es/sections/compilerOptions.md b/packages/tsconfig-reference/copy/es/sections/compilerOptions.md new file mode 100644 index 000000000000..7c93a0e68d38 --- /dev/null +++ b/packages/tsconfig-reference/copy/es/sections/compilerOptions.md @@ -0,0 +1,3 @@ +### Opciones del compilador + +Estas opciones constituyen la mayor parte de la configuración de TypeScript y cubre cómo debe funcionar el lenguaje. diff --git a/packages/tsconfig-reference/copy/es/sections/top_level.md b/packages/tsconfig-reference/copy/es/sections/top_level.md new file mode 100644 index 000000000000..239ab7896051 --- /dev/null +++ b/packages/tsconfig-reference/copy/es/sections/top_level.md @@ -0,0 +1,3 @@ +### Campos raíces + +Las opciones principales son las opciones raices en el archivo TSConfig - estas opciones se relacionan con la configuración de su proyecto TypeScript o JavaScript. diff --git a/packages/tsconfig-reference/copy/es/sections/watchOptions.md b/packages/tsconfig-reference/copy/es/sections/watchOptions.md new file mode 100644 index 000000000000..e69de29bb2d1