Eseguire il debug di un'app JavaScript o TypeScript in Visual Studio

È possibile eseguire il debug di codice JavaScript e TypeScript con Visual Studio. È possibile raggiungere i punti di interruzione, collegare il debugger, controllare le variabili, visualizzare lo stack di chiamate e usare altre funzionalità di debug.

Suggerimento

Se non è ancora stato installato Visual Studio, accedere alla pagina Download di Visual Studio per installarlo gratuitamente. Se si sviluppano applicazioni Node.js, è necessario installare il carico di lavoro di sviluppo Node.js con Visual Studio.

Eseguire il debug di script lato server

1. Con il progetto aperto in Visual Studio, aprire un file JavaScript lato server (ad esempio server.js), fare clic nella barra per impostare un punto di interruzione:

   

   I punti di interruzione sono la caratteristica più basilare ed essenziale di un debug affidabile. Un punto di interruzione indica dove Visual Studio deve sospendere il codice in esecuzione, in modo da poter esaminare i valori delle variabili o il comportamento della memoria oppure se viene eseguito o meno un ramo di codice.

2. Per eseguire l'app premere F5 (Debug>Avvia debug).

   Il debugger viene sospeso nel punto di interruzione impostato (l'IDE evidenzia l'istruzione in sfondo giallo). A questo punto, è possibile controllare lo stato dell'app passando il puntatore del mouse sulle variabili attualmente nell'ambito, usando finestre del debugger come variabili locali e espressioni di controllo .

   

3. Premere F5 per continuare con l'esecuzione dell'app.

4. Se vuoi usare Chrome Developer Tools, premi F12 nel browser Chrome. Usando questi strumenti, è possibile esaminare il DOM o interagire con l'app usando la console JavaScript.

Debug di script lato client

Visual Studio offre supporto per il debug sul lato client solo per Chrome e Microsoft Edge (Chromium). In alcuni scenari, il debugger raggiunge automaticamente i punti di interruzione nei codici JavaScript e TypeScript e negli script incorporati nei file HTML.

• Per il debug dello script sul lato client nelle app ASP.NET, scegliere Strumenti>Opzioni>debug e quindi selezionare Abilita debug JavaScript per ASP.NET (Chrome, Edge e Internet Explorer).

  Per informazioni più dettagliate, vedere il post di blog Debug di JavaScript in Microsoft Edge e questo post per Google Chrome. Per il debug di TypeScript in ASP.NET Core, vedere Aggiungere TypeScript a un'app ASP.NET Core esistente.

• Per Node.js applicazioni e altri progetti JavaScript, seguire la procedura descritta qui.

Nota

Per ASP.NET e ASP.NET Core, eseguire il debug di script incorporati in . I file CSHTML non sono supportati. Il codice JavaScript deve trovarsi in file separati per abilitare il debug.

Preparare l'app per il debug

Se l'origine viene minimizzata o creata da un transpiler come TypeScript o Babel, usare le mappe di origine per un'esperienza di debug ottimale. È anche possibile collegare il debugger a uno script lato client in esecuzione senza le mappe di origine. Tuttavia, è possibile impostare e raggiungere solo i punti di interruzione nel file minified o transpiled, non nel file di origine. Ad esempio, in un'app Vue.js, lo script minimizzato viene passato come stringa a un'istruzione eval e non è possibile eseguire in modo efficace questo codice usando il debugger di Visual Studio a meno che non si usino mappe di origine. Per scenari di debug complessi, è possibile usare gli strumenti di sviluppo chrome o gli strumenti F12 per Microsoft Edge.

Per informazioni sulla generazione di mappe di origine, vedere Generare mappe di origine per il debug.

Preparare il browser per il debug

Per questo scenario, usare Microsoft Edge (Chromium) o Chrome.

1. Chiudere tutte le finestre per il browser di destinazione.

   Altre istanze del browser possono impedire l'apertura del browser con il debug abilitato. Le estensioni del browser potrebbero essere in esecuzione e intercettare la modalità di debug completa, quindi potrebbe essere necessario aprire Gestione attività per trovare e chiudere istanze impreviste di Chrome.

   Per ottenere risultati ottimali, arrestare tutte le istanze di Chrome, anche se si usa Microsoft Edge (Chromium). Entrambi i browser usano la stessa codebase chromium.

2. Avviare il browser con il debug abilitato.

   A partire da Visual Studio 2019, è possibile impostare il flag all'avvio del --remote-debugging-port=9222 browser selezionando Sfoglia con...> dalla barra degli strumenti Debug .

   

   Se il comando Sfoglia con non viene visualizzato nella barra degli strumenti Debug, selezionare un browser diverso e quindi riprovare.

   Nella finestra di dialogo Sfoglia con scegliere Aggiungi e quindi impostare il flag nel campo Argomenti . Usare un nome descrittivo diverso per il browser, ad esempio Edge con debug o Chrome con debug. Per informazioni dettagliate, vedere le note sulla versione.

   

   In alternativa, aprire il comando Esegui dal pulsante Start di Windows (fare clic con il pulsante destro del mouse e scegliere Esegui) e immettere il comando seguente:

   msedge --remote-debugging-port=9222

   o

   chrome.exe --remote-debugging-port=9222

   Verrà avviato il browser con il debug abilitato.

   L'app non è ancora in esecuzione, quindi si ottiene una pagina del browser vuota.

Collegare il debugger allo script lato client

Per collegare il debugger da Visual Studio e raggiungere i punti di interruzione nel codice lato client, è necessario assistenza per identificare il processo corretto. Ecco un modo per abilitarlo.

1. Passare a Visual Studio e quindi impostare un punto di interruzione nel codice sorgente, che potrebbe essere un file JavaScript, un file TypeScript o un file JSX. Impostare il punto di interruzione in una riga di codice che consenta punti di interruzione, ad esempio un'istruzione return o una dichiarazione var.

   

   Per trovare il codice specifico in un file transpiled, usare CTRL+F (Modifica>ricerca e sostituisci>ricerca rapida).

   Per il codice lato client, per raggiungere un punto di interruzione in un file TypeScript, vue o JSX richiede in genere l'uso delle mappe di origine. Una mappa di origine deve essere configurata correttamente per supportare il debug in Visual Studio.

2. Selezionare il browser di destinazione come destinazione di debug in Visual Studio, quindi premere CTRL+F5 (Avvia debug>senza eseguire debug) per eseguire l'app nel browser.

   Se è stata creata una configurazione del browser con un nome descrittivo, scegliere tale configurazione come destinazione di debug. L'app viene aperta in una nuova scheda del browser.

3. Scegliere Debug>Associa a processo.

   Suggerimento

   A partire da Visual Studio 2017, dopo aver eseguito la prima connessione al processo seguendo questi passaggi, è possibile ricollegare rapidamente lo stesso processo scegliendo Debug>Ricollegamento a processo.

4. Nella finestra di dialogo Connetti a processo ottenere un elenco filtrato di istanze del browser a cui è possibile connettersi. Scegliere il debugger corretto per il browser di destinazione, JavaScript (Chrome) o JavaScript (Microsoft Edge - Chromium) nel campo Collega a , digitare chrome o bordo nella casella di filtro per filtrare i risultati della ricerca.

5. Selezionare il processo del browser con la porta host corretta (localhost in questo esempio) e selezionare Connetti.

   La porta (ad esempio, 1337) può essere visualizzata anche nel campo Titolo per facilitare la selezione dell'istanza corretta del browser.

   L'esempio seguente mostra come cerca il browser Microsoft Edge (Chromium).

   

   Suggerimento

   Se il debugger non è collegato e viene visualizzato il messaggio "Failed to launch debug adapter" (Impossibile avviare l'adattatore di debug) o "Impossibile connettersi al processo. Un'operazione non è valida nello stato corrente. Usare Gestione attività di Windows per chiudere tutte le istanze del browser di destinazione prima di avviare il browser in modalità di debug. Le estensioni del browser possono essere in esecuzione e impedire la modalità di debug completa.

6. Il codice con il punto di interruzione potrebbe essere già stato eseguito, aggiornare la pagina del browser. Se necessario, eseguire un'azione per fare in modo che il codice con il punto di interruzione venga eseguito.

   Durante la pausa del debugger, è possibile esaminare lo stato dell'app passando il mouse sulle variabili e usando le finestre del debugger. È possibile far avanzare il debugger eseguendo il codice istruzione per istruzione (F5, F10 e F11). Per altre informazioni sulle funzionalità di debug di base, vedere Prima di tutto esaminare il debugger.

   È possibile raggiungere il punto di interruzione in un file transpiled .js o in un file di origine, a seconda del tipo di app, dei passaggi seguiti in precedenza e di altri fattori, ad esempio lo stato del browser. In entrambi i casi è possibile eseguire il codice istruzione per istruzione ed esaminare le variabili.

   • Se è necessario suddividere il codice in un file TypeScript, JSX o .vue di origine e non è possibile farlo, assicurarsi che l'ambiente sia configurato correttamente, come descritto nella sezione Risoluzione dei problemi .

   • Se è necessario suddividere il codice in un file JavaScript transpiled (ad esempio, app-bundle.js) e non è possibile eseguire questa operazione, rimuovere il file della mappa di origine, filename.js.map.

Risoluzione dei problemi relativi a punti di interruzione e mappe di origine

Se è necessario suddividere il codice in un file di origine TypeScript o JSX e non è possibile farlo, usare Collega a processo come descritto nella sezione precedente per collegare il debugger. Assicurarsi che l'ambiente sia configurato correttamente:

• Chiudere tutte le istanze del browser, incluse le estensioni chrome (usando Gestione attività), in modo da poter eseguire il browser in modalità di debug.

• Assicurarsi di avviare il browser in modalità di debug.

• Assicurarsi che il file di mapping di origine includa il percorso relativo corretto del file di origine e che non includa prefissi non supportati, ad esempio webpack:///, che impedisce al debugger di Visual Studio di individuare un file di origine. Ad esempio, un riferimento come webpack:///.app.tsx potrebbe essere corretto in ./app.tsx. È possibile eseguire questa operazione manualmente nel file della mappa di origine (utile per il test) o tramite una configurazione di compilazione personalizzata. Per altre informazioni, vedere Generare mappe di origine per il debug.

In alternativa, se è necessario suddividere il codice in un file di origine (ad esempio, app.tsx) e non è possibile farlo, provare a usare l'istruzione debugger; nel file di origine o impostare punti di interruzione in Chrome Developer Tools (o F12 Tools per Microsoft Edge).

Generare mappe di origine per il debug

Visual Studio è in grado di usare e generare mapping di origine su file di origine JavaScript. Questo è spesso necessario se l'origine è minimizzata o creata da un transpiler come Babel o TypeScript. Le opzioni disponibili dipendono dal tipo di progetto.

• Per impostazione predefinita, un progetto TypeScript in Visual Studio genera mapping di origine. Per altre informazioni, vedere Configurare le mappe di origine usando un file di tsconfig.json.

• In un progetto JavaScript è possibile generare mappe di origine usando un bundler come webpack e un compilatore come il compilatore TypeScript (o Babel), che è possibile aggiungere al progetto. Per il compilatore TypeScript, è necessario aggiungere anche un tsconfig.json file e impostare l'opzione del sourceMap compilatore. Per un esempio che illustra come eseguire questa operazione usando una configurazione webpack di base, vedere Creare un'app Node.js con React.

Nota

Se non si ha ancora una volta le mappe di origine, leggere What are Source Mappe? (Informazioni sulle Mappe di origine) prima di continuare.

Per configurare le impostazioni avanzate per le mappe di origine, usare una tsconfig.json o le impostazioni del progetto in un progetto TypeScript, ma non entrambe.

Per abilitare il debug con Visual Studio, è necessario assicurarsi che i riferimenti al file di origine nella mappa di origine generata siano corretti (questo potrebbe richiedere test). Ad esempio, se si usa webpack, i riferimenti nel file della mappa di origine includono il prefisso webpack:/// , che impedisce a Visual Studio di trovare un file di origine TypeScript o JSX. In particolare, quando si corregge questo problema a scopo di debug, il riferimento al file di origine (ad esempio app.tsx), deve essere modificato da qualcosa come webpack:///./app.tsx a qualcosa come ./app.tsx, che consente il debug (il percorso è relativo al file di origine). L'esempio seguente illustra come configurare le mappe di origine in webpack, uno dei bundler più comuni, in modo che funzionino con Visual Studio.

(solo Webpack) Se si imposta il punto di interruzione in un typeScript di file JSX (anziché in un file JavaScript transpiled), è necessario aggiornare la configurazione webpack. Ad esempio, in webpack-config.js potrebbe essere necessario sostituire il codice seguente:

  output: {
    filename: "./app-bundle.js", // This is an example of the filename in your project
  },

Con questo:

  output: {
    filename: "./app-bundle.js", // Replace with the filename in your project
    devtoolModuleFilenameTemplate: '[resource-path]'  // Removes the webpack:/// prefix
  },

Si tratta di un'impostazione di sola sviluppo per abilitare il debug del codice lato client in Visual Studio.

Per scenari complessi, gli strumenti del browser (F12) talvolta funzionano meglio per il debug, perché non richiedono modifiche ai prefissi personalizzati.

Configurare i mapping di origine usando un file tsconfig.json

Se si aggiunge un tsconfig.json file al progetto, Visual Studio considera la radice della directory come progetto TypeScript. Per aggiungere il file, fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni e quindi scegliere Aggiungi > nuovo file > di configurazione JSON TypeScript. Un tsconfig.json file simile al seguente viene aggiunto al progetto.

{
  "compilerOptions": {
    "noImplicitAny": false,
    "module": "commonjs",
    "noEmitOnError": true,
    "removeComments": false,
    "sourceMap": true,
    "target": "es5"
  },
  "exclude": [
    "node_modules"
  ]
}

Opzioni del compilatore per tsconfig.json file

• inlineSourceMap: creare un singolo file con mappe di origine anziché creare una mappa di origine separata per ogni file di origine.
• inlineSources: genera l'origine insieme alle mappe di origine all'interno di un singolo file. Richiede l'impostazione di inlineSourceMap o sourceMap .
• mapRoot: specifica il percorso in cui il debugger deve trovare i file della mappa di origine (con estensione map) anziché il percorso predefinito. Usare questo flag se i file di runtime .map devono trovarsi in un percorso diverso rispetto ai .js file. Il percorso specificato è incorporato nella mappa di origine per indirizzare il debugger al percorso dei .map file.
• sourceMap: genera un file corrispondente .map .
• sourceRoot: specifica il percorso in cui il debugger deve trovare i file TypeScript anziché i percorsi di origine. Usare questo flag se le origini di runtime devono trovarsi in un percorso diverso rispetto a quello usato per la fase di progettazione. Il percorso specificato è incorporato nel mapping di origine per indirizzare il debugger alla posizione dei file di origine.

Per altri dettagli sulle opzioni del compilatore, vedere la pagina Opzioni del compilatore nel manuale di TypeScript.

Configurare le mappe di origine usando le impostazioni del progetto (progetto TypeScript)

È anche possibile configurare le impostazioni della mappa di origine usando le proprietà del progetto facendo clic con il pulsante destro del mouse sul progetto e scegliendo Proprietà > progetto > TypeScript Build > Debugging (Debug compilazione TypeScript).

Sono disponibili le impostazioni del progetto seguenti.

• Generare mappe di origine (equivalenti a sourceMap in tsconfig.json): genera il file corrispondente .map .
• Specificare la directory radice delle mappe di origine (equivalente a mapRoot in tsconfig.json): specifica il percorso in cui il debugger deve trovare i file di mapping anziché i percorsi generati. Usare questo flag se i file di runtime .map devono trovarsi in un percorso diverso rispetto ai .js file. Il percorso specificato è incorporato nel mapping di origine per indirizzare il debugger alla posizione dei file di mapping.
• Specificare la directory radice dei file TypeScript (equivalente a sourceRoot in tsconfig.json): specifica il percorso in cui il debugger deve trovare i file TypeScript anziché i percorsi di origine. Usare questo flag se i file di origine di runtime devono trovarsi in un percorso diverso rispetto a quello usato per la fase di progettazione. Il percorso specificato è incorporato nel mapping di origine per indirizzare il debugger alla posizione dei file di origine.

Debug di JavaScript in file dinamici tramite Razor (ASP.NET)

A partire da Visual Studio 2019, Visual Studio offre il supporto per il debug solo per Chrome e Microsoft Edge (Chromium).

Tuttavia, non è possibile raggiungere automaticamente i punti di interruzione nei file generati con la sintassi Razor (cshtml, vbhtml). È possibile usare due approcci per il debug di questo tipo di file:

• Posizionare l'istruzione debugger; in cui si vuole interrompere: questa istruzione determina l'arresto dell'esecuzione dello script dinamico e l'avvio del debug immediatamente durante la creazione.

• Caricare la pagina e aprire il documento dinamico in Visual Studio: è necessario aprire il file dinamico durante il debug, impostare il punto di interruzione e aggiornare la pagina per il funzionamento di questo metodo. A seconda che tu usi Chrome o Microsoft Edge (Chromium), troverai il file usando una delle strategie seguenti:

  • Per Chrome, passare a Esplora soluzioni Script Documenti > YourPageName>.

    Nota

    Quando si usa Chrome, è possibile che venga visualizzato un messaggio che indica che non è disponibile alcuna origine tra <i tag di script> . È ok, è sufficiente continuare il debug.

  • Per Microsoft Edge (Chromium), usare la stessa procedura di Chrome.

Per altre informazioni, vedere Client-side debugging of ASP.NET projects in Google Chrome (Debug lato client di progetti ASP.NET in Google Chrome).

Contenuto correlato

Proprietà, React, Angular, Vue