Referencia de la API de Console Utilities

Kayce Basques
Kayce Basques
Sofia Emelianova
Sofia Emelianova

La API de Console Utilities contiene una colección de funciones convenientes para realizar tareas comunes: seleccionar e inspeccionar elementos DOM, consultar objetos, mostrar datos en formato legible, detener e iniciar el generador de perfiles, supervisar eventos y llamadas a funciones de DOM, entre otras.

¿Buscas console.log(), console.error() y el resto de las funciones console.*? Consulta la Referencia de la API de la consola.

$_

$_ muestra el valor de la última expresión evaluada.

En el siguiente ejemplo, se evalúa una expresión simple (2 + 2). Luego, se evalúa la propiedad $_, que contiene el mismo valor:

$_ es la última expresión evaluada.

En el siguiente ejemplo, la expresión evaluada contiene inicialmente un array de nombres. Cuando se evalúa $_.length para encontrar la longitud del array, el valor almacenado en $_ cambia para convertirse en la última expresión evaluada, 4:

$_ cambia cuando se evalúan comandos nuevos.

Entre USD 0 y USD 4

Los comandos $0, $1, $2, $3 y $4 funcionan como una referencia histórica de los últimos cinco elementos del DOM que se inspeccionaron en el panel Elements o los últimos cinco objetos de montón de JavaScript seleccionados en el panel Profiles. $0 muestra el elemento o el objeto JavaScript seleccionado más recientemente, $1 muestra el segundo más recientemente seleccionado, y así sucesivamente.

En el siguiente ejemplo, se selecciona un elemento img en el panel Elements. En el panel lateral de Console, se evaluó $0 y se muestra el mismo elemento:

Ejemplo de USD 0.

En la siguiente imagen, se muestra otro elemento seleccionado en la misma página. $0 ahora hace referencia al elemento seleccionado recientemente, mientras que $1 muestra el elemento seleccionado anteriormente:

Ejemplo de USD 1.

$(selector [, nodoInicial])

$(selector) muestra la referencia al primer elemento DOM con el selector de CSS especificado. Cuando se llama con un argumento, esta función es un atajo para la función document.querySelector().

En el siguiente ejemplo, se muestra una referencia al primer elemento <img> del documento:

Ejemplo de $(&#39;img&#39;).

Haz clic con el botón derecho en el resultado que se muestra y selecciona Mostrar en el panel de elementos para encontrarlo en el DOM, o bien Desplazarse para ver para mostrarlo en la página.

En el siguiente ejemplo, se muestra una referencia al elemento actualmente seleccionado y se visualiza su propiedad src:

Ejemplo de $(&#39;img&#39;).src.

Esta función también admite un segundo parámetro, startNode, que especifica un "elemento" o nodo desde el que buscar elementos. El valor predeterminado de este parámetro es document.

En el siguiente ejemplo, se muestra una referencia al primer elemento img que es un descendiente de devsite-header-background y se muestra su propiedad src:

Ejemplo de $(&#39;img&#39;, div).src.

$$(selector [, startNode])

$$(selector) muestra un array de elementos que coinciden con el selector de CSS determinado. Este comando equivale a llamar a Array.from(document.querySelectorAll()).

En el siguiente ejemplo, se usa $$() to create an array of all <img> elements in the current document and displays the value of each element's src property:

let images = $$('img');
for (let each of images) {
  console.log(each.src);
}

Ejemplo de uso de<!-- notranslate l10n-placeholder: l10n-placeholder3 -->()</code> para crear un array de todos los <code translate=Elementos<img> que aparecen en el documento actual después del nodo seleccionado:

let images = $$('img', document.querySelector('.devsite-header-background'));
for (let each of images) {
  console.log(each.src);
}

Ejemplo del uso de $() para seleccionar todas las imágenes que aparecen después del elemento div de selección en el documento y mostrar sus fuentes.

$x(path [, startNode])

$x(path) muestra un array de elementos DOM que coinciden con la expresión XPath en cuestión.

Por ejemplo, el siguiente comando muestra todos los elementos <p> de la página:

$x("//p")

Ejemplo de cómo usar un selector XPath.

En el siguiente ejemplo, se muestran todos los elementos <p> que contienen elementos <a>:

$x("//p[a]")

Ejemplo de uso de un selector XPath más complicado.

Al igual que las otras funciones de selector, $x(path) tiene un segundo parámetro opcional, startNode, que especifica un elemento o un nodo desde el que buscar elementos.

Ejemplo de cómo usar un selector XPath con startNode.

borrar()

clear() borra el historial de la consola.

clear();

copiar(objeto)

copy(object) copia una representación de cadena del objeto especificado en el portapapeles.

copy($0);

debug(function)

Cuando se llama a la función especificada, se invoca al depurador y la función se desglosa en el panel Sources, lo que permite recorrer y depurar el código.

debug(getData);

Pausa dentro de una función con debug().

Usa undebug(fn) para finalizar el desglose de la función o usa la IU para inhabilitar todos los puntos de interrupción.

Para obtener más información sobre los puntos de interrupción, consulta Cómo pausar tu código con puntos de interrupción.

dir(object)

dir(object) muestra una lista de estilo de objeto de todas las propiedades del objeto especificado. Este método es un atajo para el método console.dir() de la API de Console.

En el siguiente ejemplo, se muestra la diferencia entre evaluar document.body directamente en la línea de comandos y usar dir() para mostrar el mismo elemento:

document.body;
dir(document.body);

Registro de document.body con y sin la función dir().

Para obtener más información, consulta la entrada console.dir() en la API de Play Console.

dirxml(objeto)

dirxml(object) imprime una representación XML del objeto especificado, como se ve en el panel Elements. Este método es equivalente al método console.dirxml().

inspeccionar(objeto/función)

inspect(object/function) abre y selecciona el elemento o objeto especificado en el panel correspondiente: el panel Elements para elementos DOM o el panel Profiles para objetos de montón JavaScript.

En el siguiente ejemplo, se abre el document.body en el panel Elementos:

inspect(document.body);

Inspecciona un elemento con inspect().

Cuando se pasa una función a inspect, la función abre el documento en el panel Sources para que lo inspecciones.

getEventListeners(object)

getEventListeners(object) muestra los objetos de escucha de eventos registrados en el objeto especificado. El valor que se muestra es un objeto que contiene un array para cada tipo de evento registrado (click o keydown, por ejemplo). Los miembros de cada array son objetos que describen el objeto de escucha registrado para cada tipo. Por ejemplo, la siguiente lista muestra todos los objetos de escucha de eventos registrados en el objeto de documento:

getEventListeners(document);

Resultado de usar getEventListeners().

Si hay más de un objeto de escucha registrado en el objeto especificado, la matriz contiene un miembro para cada objeto de escucha. En el siguiente ejemplo, hay dos objetos de escucha de eventos registrados en el elemento del documento para el evento click:

Varios objetos de escucha.

Puedes expandir aún más cada uno de estos objetos para explorar sus propiedades:

Vista ampliada del objeto de escucha.

Para obtener más información, consulta Cómo inspeccionar las propiedades de un objeto.

keys(object)

keys(object) muestra un array que contiene los nombres de las propiedades que pertenecen al objeto especificado. Para obtener los valores asociados de las mismas propiedades, usa values().

Por ejemplo, supongamos que tu aplicación definió el siguiente objeto:

let player = {
    "name": "Parzival",
    "number": 1,
    "state": "ready",
    "easterEggs": 3
};

Si suponemos que player se definió en el espacio de nombres global (por cuestiones de simplicidad), escribir keys(player) y values(player) en Consola genera lo siguiente:

Ejemplo de los métodos keys() y values().

monitor(function)

Cuando se llama a la función especificada, se registra un mensaje en la consola que indica el nombre de la función junto con los argumentos que se pasan a la función cuando se la llamó.

function sum(x, y) {
  return x + y;
}
monitor(sum);

Ejemplo del método monitor().

Usa unmonitor(function) para detener la supervisión.

monitorEvents(object [, events])

Cuando uno de los eventos especificados ocurre en el objeto especificado, el objeto Event se registra en la consola. Puedes especificar un solo evento para supervisar, un array de eventos o uno de los “tipos” de eventos genéricos asignados a una colección de eventos predefinida. Consulta los ejemplos que se mencionan a continuación.

A continuación, se controlan todos los eventos resize en el objeto window.

monitorEvents(window, "resize");

Supervisa eventos de cambio de tamaño de ventana.

En el siguiente ejemplo, se define una matriz para controlar los eventos “resize” y “scroll” en el objeto window:

monitorEvents(window, ["resize", "scroll"])

También puedes especificar uno de los “tipos” de eventos disponibles, cadenas que se asignan a conjuntos predefinidos de eventos. En la siguiente tabla, se especifican los tipos de eventos disponibles y sus asignaciones de eventos asociadas:

Tipo de evento y eventos asignados correspondientes
ratón"mousedown", "mouseup", "click", "dblclick", "mousemove", "mouseover", "mouseout", "mousewheel"
clave“keydown”, “keyup”, “keypress” o “textInput”
táctil"touchstart", "touchmove", "touchend", "touchcancel"
control"resize", "scroll", "zoom", "focus", "blur", "select", "change", "submit", "reset"

Por ejemplo, a continuación se usan todos los eventos de teclas correspondientes al tipo de evento “key” en un campo de texto de entrada actualmente seleccionado en el panel Elements.

monitorEvents($0, "key");

A continuación, se muestran resultados de ejemplo tras ingresar caracteres en el campo de texto:

Supervisa los eventos de tecla.

Usa unmonitorEvents(object[, events]) para detener la supervisión.

profile([name]) y profileEnd([name])

profile() inicia una sesión de generación de perfiles de CPU de JavaScript con un nombre opcional. profileEnd() completa el perfil y muestra los resultados en la pista Rendimiento > Principal.

Para iniciar la generación de perfiles, haz lo siguiente:

profile("Profile 1")

Para detener el perfilamiento y ver los resultados en la pista Rendimiento > Principal, haz lo siguiente:

profileEnd("Profile 1")

Como resultado, en la pista Rendimiento > Principal:

Perfil 1 en el segmento principal de Rendimiento.

Los perfiles también se pueden anidar. Por ejemplo, lo siguiente funcionará en cualquier orden:

profile('A');
profile('B');
profileEnd('A');
profileEnd('B');

queryObjects(Constructor)

Llama a queryObjects(Constructor) desde la consola para mostrar un array de objetos que se crearon con el constructor especificado. Por ejemplo:

  • queryObjects(Promise): Muestra todas las instancias de Promise.
  • queryObjects(HTMLElement). Muestra todos los elementos HTML.
  • queryObjects(foo), en el que foo es un nombre de clase. Muestra todos los objetos a los que se les creó una instancia a través de new foo().

El alcance de queryObjects() es el contexto de ejecución seleccionado actualmente en la consola.

table(data [, columns])

Registra datos de objetos con formato de tabla: pasa un objeto de datos con encabezados de columna opcionales. Este es un acceso directo para console.table().

Por ejemplo, para mostrar una lista de nombres usando una tabla en la consola, debes hacer lo siguiente:

let names = [
  { firstName: "John", lastName: "Smith" },
  { firstName: "Jane", lastName: "Doe" },
];
table(names);

Ejemplo del método table().

undebug(function)

undebug(function) detiene la depuración de la función especificada para que, cuando se llame a la función, ya no se invoque el depurador. Se usa en conjunto con debug(fn).

undebug(getData);

unmonitor(función)

unmonitor(function) detiene la supervisión de la función especificada. Se usa en conjunto con monitor(fn).

unmonitor(getData);

unmonitorEvents(object [, events])

unmonitorEvents(object[, events]) detiene los eventos de supervisión del objeto y los eventos especificados. Por ejemplo, con lo siguiente se detiene todo el control de eventos en el objeto window:

unmonitorEvents(window);

También puedes dejar de controlar, de manera selectiva, eventos específicos que en un objeto. Por ejemplo, el siguiente código inicia el control de todos los eventos del mouse en el elemento actualmente seleccionado y, luego, deja de controlar los eventos “mousemove” (posiblemente para disminuir el ruido en la salida de la consola):

monitorEvents($0, "mouse");
unmonitorEvents($0, "mousemove");

values(object)

values(object) muestra un array que contiene los valores de todas las propiedades que pertenecen al objeto especificado.

let player = {
    "name": "Parzival",
    "number": 1,
    "state": "ready",
    "easterEggs": 3
};

values(player);

Es el resultado de values(player).