-
Notifications
You must be signed in to change notification settings - Fork 129
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #1 from microsoft/main
INIT traduzione italiana
- Loading branch information
Showing
9 changed files
with
147 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
## Introduzione alla TSConfig Reference | ||
|
||
Un file TSConfig in una cartella indica che la cartella in questione è la root di un progetto TypeScript o JavaScript. Il file TSConfig può essere sia un `tsconfig.json` che `jsconfig.json`, entrambi hanno la stessa forma e le stesse variabili di configurazione. | ||
|
||
Questa pagina copre tutte le diverse variabili disponibili in un file TSConfig. Esso inizia con un introduzione su ogni variabile, poi si addentra negli attributi principali del file JSON, poi prosegue con il `compilerOptions` che comprende la maggior parte delle opzioni e delle conclusioni con `watchOptions`. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,39 @@ | ||
--- | ||
display: "Consentire JS" | ||
oneline: "Consentire di importare i file .js" | ||
--- | ||
|
||
Si può consentire ai file JavaScript di poter essere importati nel tuo progetto TypeScript. Per esempio, questo file JS: | ||
|
||
```js twoslash | ||
// @filename: carta.js | ||
export const seme = 'Cuori'; | ||
``` | ||
|
||
Quando lo importi in un file TypeScript ti uscirà un errore: | ||
|
||
```js twoslash | ||
// @errors: 2307 | ||
// @filename: carta.js | ||
module.exports.seme = "Cuori"; | ||
// ---cut--- | ||
// @filename: index.ts | ||
import { seme } from "./carta"; | ||
|
||
console.log(seme); | ||
``` | ||
|
||
Ma verrà importato senza errori con `allowJs` abilitato: | ||
|
||
```js twoslash | ||
// @filename: carta.js | ||
module.exports.seme = "Cuori"; | ||
// ---cut--- | ||
// @allowJs | ||
// @filename: index.ts | ||
import { seme } from "./carta"; | ||
|
||
console.log(seme); | ||
``` | ||
|
||
Questa opzione può essere usata come metodo per aggiungere file TypeScript in progetti JS permettendo ai file `.ts` e `.tsx` di coesistere con i file JavaScript esistenti. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,40 @@ | ||
--- | ||
display: "Controllo JS" | ||
oneline: "Eseguire o verificare i tipi nel file .js del progetto" | ||
--- | ||
|
||
Funziona insieme a `allowJs`. Quando `checkJs` è abilitato gli errori sono segnalati all'interno del file JavaScript. Questo sarebbe l'equivalente di includere `// @ts-check` all'inizio di ogni file JavaScript che è incluso nel tuo progetto. | ||
|
||
Per esempio, questo codice JavaScript è errato secondo la definizione del tipo `parseFloat` che è presente su TypeScript: | ||
|
||
```js | ||
// parseFloat riceve solo una stringa | ||
module.exports.pi = parseFloat(3.124) | ||
``` | ||
|
||
Quando viene importato in un modulo TypeScript: | ||
|
||
```ts twoslash | ||
// @allowJs | ||
// @filename: costanti.js | ||
module.exports.pi = parseFloat(3.124); | ||
|
||
// @filename: index.ts | ||
import { pi } from "./costanti"; | ||
console.log(pi); | ||
``` | ||
|
||
Non verranno segnalati errori. Tuttavia, se abiliti `checkJs` riceverai un messaggio di errore dal file JavaScript. | ||
|
||
```ts twoslash | ||
// @errors: 2345 | ||
// @allowjs: true | ||
// @checkjs: true | ||
// @filename: costanti.js | ||
module.exports.pi = parseFloat(3.124); | ||
|
||
// @filename: index.ts | ||
import { pi } from "./costanti"; | ||
console.log(pi); | ||
``` | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,16 @@ | ||
--- | ||
display: "Componi" | ||
oneline: "Usato per creare varie build dello stesso progetto" | ||
--- | ||
|
||
L'opzione `composite` applica delle regole che permettono agli strumenti di build (incluso Typescript stesso, sotto `--build` mode) di determinare velocemente se un progetto è già stato compilato. | ||
|
||
Quando esso è attivato: | ||
|
||
- L'opzione `rootDir`, se non impostata esplicitamente, imposta in modo predefinito la cartella in cui si trova il `tsconfig.json` file. | ||
|
||
- Tutti i file implementati devono corrispondere ad un `include` o devono essere indicati nell'array `files`. Se questa regola non viene rispettata, `tsc` ti informerà su quali file non sono stati specificati. | ||
|
||
- `declaration` è predefinito su `true` | ||
|
||
Puoi trovare la documentazione sui progetti TypeScript nella [guida](https://www.typescriptlang.org/docs/handbook/project-references.html). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,32 @@ | ||
--- | ||
display: "Dichiarazione" | ||
oneline: "Creazione di file d.ts per gestire le importazioni di un progetto" | ||
--- | ||
|
||
Si possono creare dei file `.d.ts` per ogni file TypeScript o JavaScript all'interno del tuo progetto. | ||
Questi file `.d.ts` contengono delle definizioni dei file che descrivono l'API esterna al tuo modulo. | ||
Con i file `.d.ts`, strumenti come TypeScript possono dare intellisense e suggerimenti sui tipi per il codice senza tipo. | ||
|
||
Quando `declaration` è impostato su `true`, eseguendo il compilatore con questo codice TypeScript: | ||
|
||
```ts twoslash | ||
export let ciaoMondo = "Ciao!"; | ||
``` | ||
|
||
Esso genererà un file `index.js` come questo: | ||
|
||
```ts twoslash | ||
// @showEmit | ||
export let ciaoMondo = "Ciao!"; | ||
``` | ||
|
||
Con un corrispondente `ciaoMondo.d.ts`: | ||
|
||
```ts twoslash | ||
// @showEmittedFile: index.d.ts | ||
// @showEmit | ||
// @declaration | ||
export let ciaoMondo: string; | ||
``` | ||
|
||
Quando si lavora con i file `.d.ts` insieme ai file JavaScript potresti voler usare [`emitDeclarationOnly`](#emitDeclarationOnly) o [`outDir`](#outDir) per essere sicuro che i file JavaScript non vengano sovrascritti. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,9 @@ | ||
--- | ||
display: "Mappa delle dichiarazioni" | ||
oneline: "Crea una source map per tutti i file .d.ts" | ||
--- | ||
|
||
Crea una source map per i file `.d.ts` che riportano al file originale `.ts`. | ||
Questo permetterà agli editor come ad esempio VS Code di andare nel file `.ts` originale quando si usano funzioni tipo _Vai alla definizione_. | ||
|
||
Dovresti prendere seriamente in considerazione di abilitare questa funzione se stai usando le project references. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,3 @@ | ||
### Opzioni del Compilatore | ||
|
||
Queste opzioni espicitano la configurazione di TypeScript e spiegano come il linguaggio dovrebbe funzionare. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,3 @@ | ||
### Campi principali | ||
|
||
Le principali opzioni sono nel TSConfig - queste opzioni spiegano come il tuo progetto TypeScript o JavaScript è impostato. |
Empty file.