Skip to content

Commit ee7b20e

Browse files
authored
Merge pull request #3823 from pablo-maff/update-part9-spanish
Update part9 spanish
2 parents 66d856e + 8be8139 commit ee7b20e

File tree

3 files changed

+19
-17
lines changed

3 files changed

+19
-17
lines changed

src/content/9/en/part9.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ lang: en
88

99
This part is all about TypeScript: an open-source typed superset of JavaScript developed by Microsoft that compiles to plain JavaScript.
1010

11-
In this part, we will be using the tools previously introduced to build end-to-end features to an existing ecosystem with linters predefined and an existing codebase writing TypeScript. After doing this part, you should be able to understand, develop and configure projects using TypeScript.
11+
In this part, we will be using the tools previously introduced to build end-to-end features to an existing ecosystem, with predefined linters and an existing codebase, while writing TypeScript. After doing this part, you should be able to understand, develop and configure projects using TypeScript.
1212

1313
This part is created by [Tuomo Torppa](https://www.linkedin.com/in/tuomotorppa), [Tuukka Peuraniemi](https://www.linkedin.com/in/tuukkapeuraniemi/) and [Jani Rapo](https://www.linkedin.com/in/jani-rapo-5520817b/), the awesome developers of [Terveystalo](https://www.terveystalo.com/fi/Yritystietoa/Terveystalo-tyontantajana/Digital-Health/), the largest private healthcare service provider in Finland. Terveystalo’s nationwide network covers 300 locations across Finland. The clinic network is supplemented by 24/7 digital services.
1414

src/content/9/es/part9.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,11 @@ lang: es
88

99
Esta parte trata sobre TypeScript: un superconjunto de JavaScript de código abierto desarrollado por Microsoft que se compila en JavaScript simple.
1010

11-
En esta parte, utilizaremos las herramientas introducidas anteriormente para crear funciones de extremo a extremo en un ecosistema existente con linters predefinidos y una base de código existente en TypeScript. Después de hacer esta parte, debería poder comprender, desarrollar y configurar proyectos utilizando TypeScript.
11+
En esta parte, utilizaremos las herramientas introducidas anteriormente para añadir funcionalidades end-to-end a un ecosistema existente, con linters predefinidos y una base de código existente, mientras escribimos TypeScript. Después de hacer esta parte, deberías poder comprender, desarrollar y configurar proyectos utilizando TypeScript.
1212

1313
Esta parte fue creada por [Tuomo Torppa](https://www.linkedin.com/in/tuomotorppa), [Tuukka Peuraniemi](https://www.linkedin.com/in/tuukkapeuraniemi/) y [Jani Rapo](https://www.linkedin.com/in/jani-rapo-5520817b/), los increíbles desarrolladores de [Terveystalo](https://www.terveystalo.com/fi/Yritystietoa/Terveystalo-tyontantajana/Digital-Health/), el proveedor de servicios de salud privado más grande de Finlandia. La red nacional de Terveystalo cubre 300 ubicaciones en Finlandia. La red de clínicas se complementa con servicios digitales 24/7.
1414

15-
<i>Parte actualizada el 12 Feb 2023</i>
16-
- <i>Clarificación del contenido, la estructura de la app de ejemplo Patientor ha sido refactorizada a un formato mucho más simple</i>
15+
<i>Parte actualizada el 28 de Agosto de 2024</i>
16+
- <i>Librería Zod para validar el tipo del cuerpo de la petición</i>
1717

1818
</div>

src/content/9/es/part9a.md

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ lang: es
1111

1212
### Principio fundamental
1313

14-
TypeScript es un superconjunto tipado de JavaScript y, finalmente, se compila en código JavaScript simple. El programador puede incluso decidir la versión del código generado, siempre que sea ECMAScript 3 o más reciente. Que Typescript sea un superconjunto de JavaScript significa que incluye todas las características de JavaScript y sus propias características adicionales. De hecho, todo el código JavaScript existente es TypeScript válido.
14+
TypeScript es un superconjunto tipado de JavaScript y, eventualmente, es compilado en código JavaScript simple. El programador puede incluso decidir la versión del código generado, siempre que sea ECMAScript 3 o más reciente. Que Typescript sea un superconjunto de JavaScript significa que incluye todas las características de JavaScript y sus propias características adicionales. De hecho, todo el código JavaScript existente es TypeScript válido.
1515

1616
TypeScript consta de tres partes separadas, pero que se complementan entre sí:
1717

@@ -52,20 +52,25 @@ const age = 22;
5252
console.log(birthdayGreeter(birthdayHero, age));
5353
```
5454

55+
#### Palabras clave
56+
57+
Las palabras clave en TypeScript son palabras especialmente reservadas que tienen un significado teleológico designado dentro de la construcción del lenguaje. No pueden utilizarse como identificadores (nombres de variables, nombres de funciones, nombres de clases, etc.) porque forman parte de la sintaxis del lenguaje. Un intento de usar estas palabras clave resultará en un error de sintaxis o semántico. Hay alrededor de 40-50 palabras clave en TypeScript. Algunas de estas palabras clave incluyen: type, enum, interface, void, null, instanceof, etc.
58+
Una cosa a tener en cuenta es que TypeScript hereda todas las palabras clave reservadas de JavaScript, además de agregar algunas propias relacionadas con tipos, como interface, type, enum, etc.
59+
5560
#### Tipado estructural
5661

5762
TypeScript es un lenguaje tipado estructuralmente. En el tipado estructural, se considera que dos elementos son compatibles entre sí cuando por cada característica dentro del tipo del primer elemento, existe una característica correspondiente e idéntica dentro del tipo del segundo elemento. Se considera que dos tipos son idénticos si son compatibles entre sí.
5863

5964
#### Inferencia de tipos
6065

61-
El compilador de TypeScript puede intentar inferir la información del tipo si no se ha especificado ningún tipo. El tipo de variable se puede inferir en función de su valor asignado y su uso. La inferencia de tipos tiene lugar al inicializar variables y miembros, establecer valores predeterminados de parámetros, y al determinar los tipos de retorno de funciones.
66+
El compilador de TypeScript puede intentar inferir la información del tipo si no se ha especificado ningún tipo. Los tipos de las variables pueden inferirse en función de su valor asignado y su uso. La inferencia de tipos tiene lugar al inicializar variables y miembros, establecer valores predeterminados de parámetros, y al determinar los tipos de retorno de funciones.
6267

6368
Por ejemplo, considera la función *add*
6469

6570
```js
6671
const add = (a: number, b: number) => {
67-
/* The return value is used to determine
68-
the return type of the function */
72+
/* El valor de retorno es utilizado para determinar
73+
el tipo de retorno de la función */
6974
return a + b;
7075
}
7176
```
@@ -94,20 +99,18 @@ La falta de información sobre el tipo durante el tiempo de ejecución puede res
9499

95100
### ¿Por qué debería uno usar TypeScript?
96101

97-
En diferentes foros, es posible que encuentres muchos argumentos diferentes a favor o en contra de TypeScript. La verdad es probablemente tan vaga como: depende de tus necesidades y del uso de las funciones que ofrece TypeScript. De todos modos, aquí tienes algunas de nuestras razones por las que pensamos que el uso de TypeScript puede tener algunas ventajas.
102+
En diferentes foros, es posible que encuentres muchos argumentos diferentes a favor o en contra de TypeScript. La verdad probablemente sea tan ambigua, ya que depende de tus necesidades y del uso de las funciones que ofrece TypeScript. De todos modos, aquí tienes algunas de nuestras razones por las que pensamos que el uso de TypeScript puede tener algunas ventajas.
98103

99104
En primer lugar, TypeScript ofrece <i>verificación de tipos y análisis de código estático</i>. Podemos requerir que los valores sean de cierto tipo y que el compilador advierta sobre su uso incorrecto. Esto puede reducir los errores durante el tiempo de ejecución, e incluso es posible que pueda reducir la cantidad de pruebas unitarias requeridas en un proyecto, al menos en lo que respecta a las pruebas de tipo puro.
100105
El análisis de código estático no solo advierte sobre el uso incorrecto de tipos, sino también sobre otros errores, como escribir mal el nombre de una variable o función o intentar usar una variable más allá de su scope.
101106

102-
La segunda ventaja de TypeScript es que las anotaciones de tipo en el código pueden funcionar como una especie de <i>documentación a nivel de código</i>.
103-
Es fácil verificar a partir de la firma de una función qué tipo de argumentos puede consumir y qué tipo de datos devolverá. Esta forma de documentación vinculada con anotaciones de tipo siempre estará actualizada y facilita a los nuevos programadores comenzar a trabajar en un proyecto existente. También es útil al volver a trabajar en un proyecto antiguo.
107+
La segunda ventaja de TypeScript es que las anotaciones de tipo en el código pueden funcionar como una especie de <i>documentación a nivel de código</i>. Es fácil verificar a partir de la firma de una función qué tipo de argumentos puede consumir y qué tipo de datos devolverá. Esta forma de documentación vinculada con anotaciones de tipo siempre estará actualizada y facilita a los nuevos programadores comenzar a trabajar en un proyecto existente. También es útil al volver a trabajar en un proyecto antiguo.
104108

105109
Los tipos se pueden reutilizar en toda la base de código, y un cambio en una definición de tipo se reflejará automáticamente en todos los lugares donde se use el tipo. Se podría argumentar que puedes lograr una documentación de nivel de código similar con, por ejemplo, [JSDoc](https://jsdoc.app/about-getting-started.html), pero no está conectado al código tan estrechamente como los tipos de TypeScript y, por lo tanto, puede salir de sincronización más fácilmente y también es más verboso.
106110

107111
La tercera ventaja de TypeScript es que los IDE pueden proporcionar <i>IntelliSense más específico e inteligente</i> cuando saben exactamente qué tipos de datos estás procesando.
108112

109-
Todas estas características son extremadamente útiles cuando necesitas refactorizar tu código. El análisis de código estático te advierte sobre cualquier error en tu código, y el IntelliSense puede darte pistas sobre las propiedades disponibles e incluso posibles opciones de refactorización. La documentación a nivel de código te ayuda a comprender el código existente.
110-
Con la ayuda de TypeScript, también es muy fácil comenzar a usar las funciones más nuevas del lenguaje JavaScript en una etapa temprana, simplemente modificando su configuración.
113+
Todas estas características son extremadamente útiles cuando necesitas refactorizar tu código. El análisis de código estático te advierte sobre cualquier error en tu código, y el IntelliSense puede darte pistas sobre las propiedades disponibles e incluso posibles opciones de refactorización. La documentación a nivel de código te ayuda a comprender el código existente. Con la ayuda de TypeScript, también es muy fácil comenzar a usar las funciones más nuevas del lenguaje JavaScript en una etapa temprana, simplemente modificando su configuración.
111114

112115
### ¿Qué no corrige TypeScript?
113116

@@ -118,13 +121,12 @@ Por último, a continuación, enumeramos algunos problemas que muchos tienen con
118121
#### Tipos incompletos, no válidos o faltantes en librerías externas
119122

120123
Al usar librerías externas, es posible que algunas tengan declaraciones de tipos faltantes o que de alguna manera no sean válidos. La mayoría de las veces, esto se debe a que la biblioteca no está escrita en TypeScript, y a que la persona que agrega las declaraciones de tipo manualmente no esté haciendo un buen trabajo con ella. En estos casos, es posible que debas definir las declaraciones de tipo tú mismo.
121-
Sin embargo, es muy probable que alguien ya haya agregado los tipos al paquete que estás utilizando. Verifica siempre primero la página de Github [DefinitelyTyped](https://github.com/DefinitelyTyped/DefinitelyTyped). Probablemente sea la fuente más popular para los archivos de declaración de tipos. De lo contrario, es posible que desees comenzar familiarizándote con la propia [documentación](https://www.typescriptlang.org/docs/handbook/declaration-files/introduction.html) de TypeScript con respecto a las declaraciones de tipos.
122-
124+
Sin embargo, es muy probable que alguien ya haya agregado los tipos al paquete que estás utilizando. Verifica siempre primero la página de Github [DefinitelyTyped](https://github.com/DefinitelyTyped/DefinitelyTyped). Probablemente sea la fuente más popular para los archivos de declaración de tipos.
125+
De lo contrario, es posible que desees comenzar familiarizándote con la propia [documentación](https://www.typescriptlang.org/docs/handbook/declaration-files/introduction.html) de TypeScript con respecto a las declaraciones de tipos.
123126

124127
#### A veces, la inferencia de tipos necesita ayuda
125128

126-
La inferencia de tipos en TypeScript es bastante buena pero no del todo perfecta.
127-
A veces, puedes sentir que has declarado tus tipos perfectamente, pero el compilador aún te dice que la propiedad no existe o que este tipo de uso no está permitido. En estos casos, es posible que necesites ayudar al compilador haciendo algo como una verificación de tipo "extra". Ten cuidado con la conversión de tipos (usualmente también llamado aserción de tipos) o con las guardias de tipos: al utilizarlos, básicamente le estás dando tu palabra al compilador de que el valor <i>is</i> realmente es del tipo que declaras. Es posible que desees consultar la documentación de TypeScript con respecto a las [aserciones de tipo](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#type-assertions) y a las [guardias/estrechamiento de tipo](https://www.typescriptlang.org/docs/handbook/2/narrowing.html).
129+
La inferencia de tipos en TypeScript es bastante buena pero no del todo perfecta. A veces, puedes sentir que has declarado tus tipos perfectamente, pero el compilador aún te dice que la propiedad no existe o que este tipo de uso no está permitido. En estos casos, es posible que necesites ayudar al compilador haciendo algo como una verificación de tipo "extra". Ten cuidado con la conversión de tipos (usualmente también llamado aserción de tipos) o con las guardias de tipos: al utilizarlos, básicamente le estás dando tu palabra al compilador de que el valor <i>es</i> realmente del tipo que declaras. Es posible que desees consultar la documentación de TypeScript con respecto a las [aserciones de tipo](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#type-assertions) y a las [guardias/estrechamiento de tipo](https://www.typescriptlang.org/docs/handbook/2/narrowing.html).
128130

129131
#### Errores de tipo misteriosos
130132

0 commit comments

Comments
 (0)