Oggetti debugger nativi nelle estensioni JavaScript - Oggetti di tipo

Gli oggetti debugger nativi rappresentano vari costrutti dell'ambiente debugger. Le estensioni JavaScript hanno accesso diretto al sistema di tipi del linguaggio sottostante. Questo accesso viene espresso tramite la nozione di oggetti di tipo. In questo argomento vengono descritte le proprietà associate agli oggetti di tipo.

Gli oggetti debugger nativi rappresentano vari costrutti e comportamenti dell'ambiente debugger. Gli oggetti possono essere passati a estensioni JavaScript (o acquisite in) per modificare lo stato del debugger.

Per informazioni sulle estensioni JavaScript dell'oggetto Debugger, vedere Oggetti debugger nativi in Estensioni JavaScript.

Per informazioni generali sull'uso di JavaScript, vedere Scripting del debugger JavaScript.

Oggetti type

Un oggetto type può essere acquisito in diversi modi:

• Da un oggetto Object: se uno script ha un oggetto nativo all'interno di JavaScript, è possibile accedere alla proprietà targetType su tale oggetto per ottenere un oggetto type che rappresenta il tipo statico dell'oggetto nativo.
• Dall'host: l'API host.getModuleType può essere chiamata per restituire l'oggetto type per qualsiasi tipo definito in un determinato modulo.

Dopo aver acquisito l'oggetto type, ha le proprietà seguenti:

Nome	Firma	Descrizione
name	Proprietà	Restituisce il nome del tipo.
size	Proprietà	Restituisce le dimensioni del tipo come valore a 64 bit.
typeKind	Proprietà	Restituisce il tipo del tipo come stringa. Questo può essere uno dei valori seguenti: "udt", "puntatore", "memberPointer", "array", "function", "typedef", "enum" o "intrinseco".
baseType	Proprietà	Restituisce un oggetto type per il tipo in cui è basato questo tipo. Questo non rappresenta l'ereditarietà C++. Per un tipo di puntatore, questo è il tipo della cosa a cui punta. Per un tipo di matrice, questo è il tipo contenuto nella matrice.
fields	Proprietà	Restituisce un oggetto con tutti i campi denominati del tipo accessibili come proprietà denominate. Il valore di ogni proprietà è un oggetto field , come descritto di seguito.
baseClasses	Proprietà	Restituisce una matrice di tutte le classi di base immediate del tipo. Ogni oggetto nella matrice è un oggetto classe di base , come descritto di seguito.
Functionreturntype	Proprietà	Per i tipi di funzione, questo restituisce un oggetto type che rappresenta il tipo restituito della funzione.
functionParameterTypes	Proprietà	Per i tipi di funzione, viene restituita una matrice di oggetti di tipo che rappresentano i tipi di parametro della funzione.
functionCallingConvention	Proprietà	Per i tipi di funzione, viene restituita la convenzione chiamante della funzione come stringa. Questo può essere uno dei valori seguenti: "sconosciuto", "__cdecl", "fastcall", "stdcall" o "thiscall".
pointerKind	Proprietà	Per i tipi di puntatore, questo restituisce il tipo di puntatore come stringa. Questo può essere uno dei valori seguenti: "standard", "reference", "rValueReference" o "cxHat".
memberType	Proprietà	Per i tipi di puntatore che sono puntatori membro, viene restituito un oggetto type che rappresenta la classe membro.
isGeneric	Proprietà	Restituisce se il tipo è generico o meno. Verrà restituito true per i tipi di modello.
genericArguments	Proprietà	Per i tipi generici, verrà restituita una matrice di argomenti generici. Tali argomenti possono essere argomenti di tipo o possono essere valori costanti.
isBitField	Proprietà	Restituisce se l'archiviazione per il tipo è un campo bit o meno.
bitFieldPositions	Proprietà	Per i tipi che rappresentano l'archiviazione bitfield, verrà restituito un tipo di descrizione del campo bit che indica le posizioni del campo bit.

Tutte queste voci sono presenti durante l'inizializzazione della fase 2.

Oggetti campo

Ogni campo all'interno di un tipo è descritto da un oggetto campo con proprietà come indicato di seguito:

Nome	Firma	Descrizione
name	Proprietà	Restituisce il nome del campo.
tipo	Proprietà	Restituisce un oggetto type che rappresenta il tipo statico del campo.
locationKind	Proprietà	Restituisce il tipo di posizione (archiviazione) per il campo come stringa. Questo può essere uno dei valori seguenti: "member", "static", "constant" o "none".
offset	Proprietà	Per i campi con un tipo di posizione che indica un offset ,ad esempio "membro", restituisce l'offset del campo all'interno del tipo contenente come valore a 64 bit.
posizione	Proprietà	Per i campi che hanno un tipo di posizione che indica una posizione (ad esempio: "statico"), restituisce la posizione del campo come oggetto location.
Valore	Proprietà	Per i campi con un tipo di posizione che indica un valore (ad esempio: "costante"), restituisce il valore del campo.

Tutte queste voci sono presenti durante l'inizializzazione della fase 2.

Oggetti classe base

Ogni classe base all'interno di un tipo è descritta da un oggetto classe di base con proprietà come indicato di seguito:

Nome	Firma	Descrizione
name	Proprietà	Restituisce il nome della classe di base.
offset	Proprietà	Restituisce l'offset di questa classe di base all'interno del tipo contenitore.
tipo	Proprietà	Restituisce un oggetto tipo che rappresenta il tipo statico della classe base.

Tutte queste voci sono presenti durante l'inizializzazione della fase 2.

Esempio di codice

Per un esempio di codice, vedere lo script ImageInfo.js. Per altre informazioni sugli esempi di codice, vedere Script di esempio del debugger JavaScript.

// fieldType references basic types that should be present in **ANY** symbolic information.
// Just grab the first module as the "reference module" for this purpose.  We cannot grab
// "ntdll" generically as we want to avoid a situation in which the debugger opens a module (-z ...)
// from failing.
//
var moduleName = contextInheritorModule.__ComparisonName;
var typeObject = host.getModuleType(moduleName, field.fieldType, contextInheritorModule);
var result = host.createTypedObject(addr, typeObject);

Vedere anche

Oggetti debugger nativi nelle estensioni JavaScript

Oggetti debugger nativi nelle estensioni JavaScript - Considerazioni sulla progettazione e sul test

JavaScript Debugger Scripting

Script di esempio del debugger JavaScript