Condividi tramite

Comandi della console JavaScript

  • Articolo

Si applica a Windows e Windows Phone

Puoi usare i comandi della finestra della console JavaScript di Visual Studio per inviare messaggi ed eseguire altre attività. Per esempi di utilizzo di questa finestra, vedi Guida introduttiva: Eseguire il debug di JavaScript con la console. Le informazioni contenute in questo argomento sono applicabili alle app di Windows Store e Windows Phone create con JavaScript. Per informazioni sui comandi della console supportate in app ibride per più dispositivi, vedi Eseguire il debug dell'app. Per informazioni sull'uso della console negli strumenti F12 di Internet Explorer, vedi questo argomento.

Se la finestra della console JavaScript è chiusa, puoi aprirla durante il debug in Visual Studio scegliendo Debug > Finestre > Console JavaScript.

Nota

Se la finestra non è disponibile durante una sessione di debug, verifica che il tipo di debugger sia impostato su Script nelle proprietà di debug per il progetto.

Comandi dell'oggetto console

Questa tabella mostra la sintassi per i comandi dell'oggetto console che puoi usare nella finestra della console JavaScript o che ti consentono di inviare messaggi alla console dal codice. Se ti serve, questo oggetto dispone di numerosi formati che ti consentono di distinguere i messaggi informativi dai messaggi di errore.

Nota

Puoi usare il formato del comando più lungo window.console.[command] se hai l'esigenza di evitare possibili confusioni con gli oggetti locali denominati console.

Comando

Descrizione

Esempio

assert(expression, message)

Invia un messaggio quando expression restituisce false.

console.assert((x == 1), "assert message: x != 1");

clear()

Cancella i messaggi dalla finestra della console, inclusi i messaggi di errore di script, e cancella inoltre lo script visualizzato nella finestra della console. Non cancella lo script immesso nella richiesta di input della console.

console.clear();

count(title)

Invia il numero di volte in cui è stato chiamato il comando count nella finestra della console. Ogni chiamata al comando count viene identificata in modo univoco dal parametro title facoltativo.

La voce esistente nella finestra della console viene identificata dal parametro title (se presente) e aggiornata dal comando count. Viene ora creata una nuova voce.

Requisiti:

Visual Studio 2013

console.count();

console.count("inner loop");

debug(message)

Invia message alla finestra della console.

Questo comando è identico a console.log.

Gli oggetti passati usando tale comando vengono convertiti in un valore stringa.

Requisiti:

Visual Studio 2013

console.debug("logging message");

dir(object)

Invia l'oggetto specificato alla finestra della console e lo visualizza in un visualizzatore oggetti. Puoi usare il visualizzatore di controllare le proprietà nella finestra della console.

console.dir(obj);

dirxml(object)

Invia il nodo XML object specificato alla finestra della console e lo visualizza in un albero del nodo XML.

Requisiti:

Visual Studio 2013

console.dirxaml(xmlNode);

error(message)

Invia message alla finestra della console. Il testo del messaggio è rosso ed è preceduto da un simbolo di errore.

Gli oggetti passati usando tale comando vengono convertiti in un valore stringa.

console.error("error message");

group(title)

Avvia un raggruppamento per i messaggi inviati alla finestra della console e invia il parametro title facoltativo come etichetta di gruppo. I gruppi possono essere annidati e visualizzati in una visualizzazione struttura ad albero nella finestra della console.

I comandi del gruppo* possono semplificare la visualizzazione dell'output della finestra della console in alcuni scenari, ad esempio quando viene usato un modello componente.

Requisiti:

Visual Studio 2013

 
console.log("This is the outer level");
console.group("Level 2 Header");
console.log("Level 2"); 
console.group(); 
console.log("Level 3");
console.warn("More of level 3"); 
console.groupEnd(); 
console.log("Back to level 2"); 
console.groupEnd(); 
console.debug("Back to the outer level");

groupCollapsed(title)

Avvia un raggruppamento per i messaggi inviati alla finestra della console e invia il parametro title facoltativo come etichetta di gruppo. I gruppi inviati tramite groupCollapsed vengono visualizzati per impostazione predefinita in una visualizzazione compressa. I gruppi possono essere annidati e visualizzati in una visualizzazione struttura ad albero nella finestra della console.

Requisiti:

Visual Studio 2013

L'utilizzo identico a quello del comando group.

Vedi l'esempio per il comando group.

groupEnd()

Termina il gruppo corrente.

Requisiti:

Visual Studio 2013

Vedi l'esempio per il comando group.

info(message)

Invia message alla finestra della console. Il messaggio è preceduto da un simbolo di informazioni.

console.info("info message");

Per altri esempi, vedi Formattazione dell'output di console.log più avanti in questo argomento.

log(message)

Invia message alla finestra della console.

Se passi un oggetto, questo comando lo invia alla finestra della console e lo visualizza in un visualizzatore oggetti. Puoi usare il visualizzatore di controllare le proprietà nella finestra della console.

console.log("logging message");

msIsIndependentlyComposed(element)

Usato nelle app Web. Non supportato nelle app di Store in JavaScript.

Non supportato.

profile(reportName)

Usato nelle app Web. Non supportato nelle app di Store in JavaScript.

Non supportato.

profileEnd()

Usato nelle app Web. Non supportato nelle app di Store in JavaScript.

Non supportato.

select(element)

Seleziona l'elemento element HTML specificato in DOM Explorer.

Requisiti:

Visual Studio 2013

console.select(element);

time (name)

Avvia un timer identificato dal parametro facoltativo name. Se usato con console.timeEnd, calcola il tempo che passa tra time e timeEnd e invia il risultato (misurato in ms) alla console usando la stringa name come prefisso. Usato per abilitare la strumentazione del codice dell'app per la misurazione delle prestazioni.

Requisiti:

Visual Studio 2013

console.time("app start"); app.start(); console.timeEnd("app start");

timeEnd(name)

Arresta un timer identificato dal parametro facoltativo name. Vedi il comando della console time.

Requisiti:

Visual Studio 2013

console.time("app start"); app.start(); console.timeEnd("app start");

trace()

Invia una traccia dello stack nella finestra della console. La traccia include lo stack di chiamate completo e informazioni quali il nome file, il numero di riga e il numero di colonna.

Requisiti:

Visual Studio 2013

console.trace();

warn(message)

Invia message alla finestra della console, preceduto da un simbolo di avviso.

Gli oggetti passati usando tale comando vengono convertiti in un valore stringa.

console.warn("warning message");

Comandi diversi

Questi comandi sono anche disponibili nella finestra della console JavaScript.

Comando

Descrizione

Esempio

$0, $1, $2, $3, $4

Restituisce l'elemento specificato nella finestra della console. $0 restituisce l'elemento attualmente selezionato in DOM Explorer, $1 restituisce l'elemento selezionato in precedenza in DOM Explorer e così via, fino al quarto elemento selezionato in precedenza.

$3

$(id)

Restituisce un elemento tramite ID. Si tratta di un comando di scelta rapida per document.getElementById(id), dove id è una stringa che rappresenta l'ID dell'elemento

$("contenthost")

$$(selector)

Restituisce una matrice di elementi che corrispondono al selettore specificato usando la sintassi del selettore CSS. Si tratta di un comando di scelta rapida per document.querySelectorAll().

$$(".itemlist")

cd()

cd(window)

Consente di modificare il contesto per la valutazione di un'espressione nella finestra di primo livello predefinita della pagina alla finestra del frame specificato. Chiamando cd() senza parametri, viene restituito il contesto nella finestra di primo livello.

cd();

cd(myframe);

select(element)

Seleziona l'elemento specificato in DOM Explorer.

select(document.getElementById("element"));

select($("element"));

select($1);

dir(object)

Restituisce un visualizzatore per l'oggetto specificato. Puoi usare il visualizzatore di controllare le proprietà nella finestra della console.

dir(obj);

Verifica dell'esistenza di un comando della console

Hai la possibilità di verificare l'esistenza di un comando specifico che stai tentando di usare. In questo esempio viene verificata l'esistenza del comando console.log. Se console.log esiste, viene chiamato dal codice.

if (console && console.log) {
    console.log("msg");
}

Esame degli oggetti nella finestra della console JavaScript

Quando utilizzi la finestra della console JavaScript puoi interagire con qualsiasi oggetto all'interno dell'ambito. Per controllare un oggetto esterno all'ambito nella finestra della console, usa console.log , console.dir o altri comandi del codice. In alternativa, puoi interagire con l'oggetto dalla finestra della console mentre si trova nell'ambito impostando un punto di interruzione nel codice (Punto di interruzione > Inserisci punto di interruzione).

Formattazione dell'output di console.log

Se passi più argomenti a console.log, la console li considererà come una matrice e concatenerà l'output.

var user = new Object();
user.first = "Fred";
user.last = "Smith";

console.log(user.first, user.last);
// Output:
// Fred Smith

Per formattare l'output, in console.log sono anche supportati i modelli di sostituzione "printf". Se usi i modelli di sostituzione nel primo argomento, verranno usati altri argomenti per sostituire i modelli specificati nell'ordine in cui vengono usati.

Sono supportati i modelli di sostituzione seguenti:

  • %s - stringa
    %i - intero
    %d - intero
    %f - float
    %o - oggetto
    %b - binario
    %x - esadecimale
    %e - esponente

Ecco alcuni esempi di utilizzo dei modelli di sostituzione in console.log:

var user = new Object();
user.first = "Fred";
user.last = "Smith";
user.age = 10.01;
console.log("Hi, %s %s!", user.first, user.last);
console.log("%s is %i years old!", user.first, user.age);
console.log("%s is %f years old!", user.first, user.age);

// Output:
// Hi, Fred Smith!
// Fred is 10 years old!
// Fred is 10.01 years old!

Vedere anche

Concetti

Guida introduttiva: Eseguire il debug di JavaScript con la console

Guida introduttiva: Eseguire il debug di HTML e CSS