Referência da API Console Utilitários

Kayce Basques
Kayce Basques
Sofia Emelianova
Sofia Emelianova

A API Console Utilities contém uma coleção de funções de conveniência para realizar tarefas comuns: selecionar e inspecionar elementos do DOM, consultar objetos, exibir dados em formato legível, interromper e iniciar o criador de perfil, monitorar eventos do DOM e chamadas de função e muito mais.

Procurando console.log(), console.error() e o restante das funções console.*? Consulte a Referência da API Console.

$_

$_ retorna o valor da expressão avaliada mais recentemente.

No exemplo a seguir, uma expressão simples (2 + 2) é avaliada. A propriedade $_ é avaliada, que contém o mesmo valor:

$_ é a expressão avaliada mais recentemente.

No próximo exemplo, a expressão avaliada inicialmente contém uma matriz de nomes. Ao avaliar $_.length para encontrar o tamanho da matriz, o valor armazenado em $_ muda para se tornar a última expressão avaliada, 4:

$_ muda quando novos comandos são avaliados.

US$ 0 a US$ 4

Os comandos $0, $1, $2, $3 e $4 funcionam como uma referência histórica aos últimos cinco elementos do DOM (incluindo pseudoelementos, como ::before ou ::after) inspecionados no painel Elementos ou os últimos cinco objetos de heap do JavaScript selecionados no painel Perfis. $0 retorna o elemento ou objeto JavaScript selecionado mais recentemente, $1 retorna o segundo mais recente e assim por diante.

No exemplo a seguir, um elemento img é selecionado no painel Elementos. Na gaveta Console, $0 foi avaliado e mostra o mesmo elemento:

Exemplo de US $0.

A imagem abaixo mostra um elemento diferente selecionado na mesma página. O $0 agora se refere ao elemento recém-selecionado, enquanto $1 retorna o elemento selecionado anteriormente:

Exemplo de US $1.

$(selector [, startNode])

$(selector) retorna a referência ao primeiro elemento DOM com o seletor de CSS especificado. Quando chamada com um argumento, essa função é um atalho para a função document.querySelector().

O exemplo a seguir retorna uma referência ao primeiro elemento <img> no documento:

Exemplo de $('img').

Clique com o botão direito do mouse no resultado retornado e selecione Revelar no painel "Elementos" para encontrá-lo no DOM ou Rolar para visualizar para mostrá-lo na página.

O exemplo a seguir retorna uma referência ao elemento selecionado no momento e exibe a propriedade src dele:

Exemplo de $('img').src.

Essa função também aceita um segundo parâmetro, startNode, que especifica um "elemento" ou nó em que os elementos serão pesquisados. O valor padrão desse parâmetro é document.

O exemplo a seguir retorna uma referência ao primeiro elemento img que é descendente de devsite-header-background e mostra a propriedade src:

Exemplo de $('img', div).src.

$$(selector [, startNode])

$$(seletor) retorna uma matriz de elementos que correspondem ao seletor de CSS fornecido. Esse comando é equivalente a chamar Array.from(document.querySelectorAll()).

O exemplo a seguir 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);
}
:

Exemplo de uso de<!-- notranslate l10n-placeholder: l10n-placeholder3 -->()</code> para criar uma matriz de todos os objetos <code translate=Elementos <img> que aparecem no documento atual após o nó selecionado:

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

Exemplo de uso de $() para selecionar todas as imagens que aparecem após o elemento div selecionado no documento e exibir as origens delas.

$x(path [, startNode])

$x(path) retorna uma matriz de elementos DOM que correspondem à expressão XPath fornecida.

Por exemplo, o código a seguir retorna todos os elementos <p> na página:

$x("//p")

Exemplo de uso de um seletor XPath.

O exemplo a seguir retorna todos os elementos <p> que contêm elementos <a>:

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

Exemplo de uso de um seletor XPath mais complicado.

Semelhante às outras funções de seletor, $x(path) tem um segundo parâmetro opcional, startNode, que especifica um elemento ou nó para pesquisar elementos.

Exemplo de uso de um seletor XPath com startNode.

clear()

clear() limpa o histórico do console.

clear();

copy(object)

copy(object) copia uma representação em string do objeto especificado para a área de transferência.

copy($0);

debug(function)

Quando a função especificada é chamada, o depurador é invocado e interrompe a função no painel Origens, permitindo que você percorra o código e o depure.

debug(getData);

Interromper dentro de uma função com debug().

Use undebug(fn) para interromper a interrupção na função ou use a interface para desativar todos os pontos de interrupção.

Para mais informações sobre pontos de interrupção, consulte Pausar o código com pontos de interrupção.

dir(object)

dir(object) exibe uma listagem no estilo de objeto de todas as propriedades do objeto especificado. Esse método é um atalho para o método console.dir() da API Console.

O exemplo a seguir mostra a diferença entre avaliar document.body diretamente na linha de comando e usar dir() para exibir o mesmo elemento:

document.body;
dir(document.body);

Como registrar document.body com e sem a função dir().

Para mais informações, consulte a entrada console.dir() na API Console.

dirxml(object)

dirxml(object) mostra uma representação XML do objeto especificado, como no painel Elementos. Esse método é equivalente ao método console.dirxml().

inspect(object/function)

inspect(object/function) abre e seleciona o elemento ou objeto especificado no painel adequado: o painel Elementos para elementos DOM ou o painel Perfis para objetos de heap do JavaScript.

O exemplo a seguir abre o document.body no painel Elementos:

inspect(document.body);

Como inspecionar um elemento com inspect().

Ao transmitir uma função para inspeção, ela abre o documento no painel Origens para que você possa inspecioná-lo.

getAccessibleName(node)

getAccessibleName(node) retorna o nome acessível calculado do nó do DOM especificado. Esse é o nome que as tecnologias adaptativas, como leitores de tela, anunciam para o elemento. Por exemplo, inspecione um botão no painel Elementos e execute:

getAccessibleName($0);

getAccessibleRole(node)

getAccessibleRole(node) retorna o papel de acessibilidade computado do nó do DOM especificado, como 'button', 'link' ou 'heading'. Por exemplo, inspecione um elemento no painel Elementos e execute:

getAccessibleRole($0);

getEventListeners(object)

getEventListeners(object) retorna os listeners de eventos registrados no objeto especificado. O valor de retorno é um objeto que contém uma matriz para cada tipo de evento registrado (click ou keydown, por exemplo). Os membros de cada matriz são objetos que descrevem o listener registrado para cada tipo. Por exemplo, o código a seguir lista todos os listeners de eventos registrados no objeto document:

getEventListeners(document);

Resultado do uso de getEventListeners().

Se mais de um listener estiver registrado no objeto especificado, a matriz vai conter um membro para cada listener. No exemplo a seguir, há dois listeners de eventos registrados no elemento do documento para o evento click:

Vários listeners.

Você pode expandir cada um desses objetos para analisar as propriedades deles:

Visualização expandida do objeto listener.

Para mais informações, consulte Inspecionar propriedades de objetos.

keys(object)

keys(object) retorna uma matriz que contém os nomes das propriedades que pertencem ao objeto especificado. Para receber os valores associados das mesmas propriedades, use values().

Por exemplo, suponha que seu aplicativo tenha definido o seguinte objeto:

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

Supondo que player tenha sido definido no namespace global (para simplificar), digitar keys(player) e values(player) no Console resulta no seguinte:

Exemplo dos métodos keys() e values().

monitor(function)

Quando a função especificada é chamada, uma mensagem é registrada no console indicando o nome da função e os argumentos transmitidos a ela quando foi chamada.

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

Exemplo do método monitor().

Use unmonitor(function) para interromper o monitoramento.

monitorEvents(object [, events])

Quando um dos eventos especificados ocorre no objeto especificado, o objeto de evento é registrado no console. É possível especificar um único evento para monitorar, uma matriz de eventos ou um dos "tipos" de eventos genéricos mapeados para uma coleção predefinida de eventos. Veja os exemplos abaixo.

O exemplo a seguir monitora todos os eventos de redimensionamento no objeto de janela.

monitorEvents(window, "resize");

Monitoramento de eventos de redimensionamento de janelas.

O exemplo a seguir define uma matriz para monitorar os eventos "resize" e "scroll" no objeto de janela:

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

Também é possível especificar um dos "tipos" de evento disponíveis, strings que são mapeadas para conjuntos predefinidos de eventos. A tabela abaixo lista os tipos de evento disponíveis e os mapeamentos associados:

Tipo de evento e eventos mapeados correspondentes
rato"mousedown", "mouseup", "click", "dblclick", "mousemove", "mouseover", "mouseout", "mousewheel"
chave"keydown", "keyup", "keypress", "textInput"
tocar"touchstart", "touchmove", "touchend", "touchcancel"
controle"resize", "scroll", "zoom", "focus", "blur", "select", "change", "submit", "reset"

Por exemplo, o código a seguir usa o tipo de evento "key" para todos os eventos principais correspondentes em um campo de texto de entrada selecionado no painel Elementos.

monitorEvents($0, "key");

Confira abaixo um exemplo de saída depois de digitar um caractere no campo de texto:

Monitoramento de eventos principais.

Use unmonitorEvents(object[, events]) para interromper o monitoramento.

profile([name]) e profileEnd([name])

profile() inicia uma sessão de criação de perfil de CPU do JavaScript com um nome opcional. profileEnd() conclui o perfil, abre automaticamente o painel Desempenho e mostra os resultados na faixa Principal.

Para iniciar a criação de perfil:

profile("Profile 1")

Para interromper a criação de perfil e ver os resultados na faixa Performance > Main:

profileEnd("Profile 1")

Resultado na faixa Performance > Principal:

Perfil 1 na faixa principal de desempenho.

Os perfis também podem ser aninhados. Por exemplo, isto vai funcionar em qualquer ordem:

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

queryObjects(Constructor)

Chame queryObjects(Constructor) no console para retornar uma matriz de objetos que foram criados com o construtor especificado. Exemplo:

  • queryObjects(Promise). Retorna todas as instâncias de Promise.
  • queryObjects(HTMLElement): retorna todos os elementos HTML.
  • queryObjects(foo), em que foo é o nome de uma classe. Retorna todos os objetos que foram instanciados por new foo().

O escopo de queryObjects() é o contexto de execução selecionado no momento no console.

table(data [, columns])

Registra dados de objeto com formatação de tabela transmitindo um objeto de dados com cabeçalhos de coluna opcionais. Este é um atalho para console.table().

Por exemplo, para exibir uma lista de nomes usando uma tabela no console, faça o seguinte:

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

Exemplo do método table().

Para copiar uma tabela registrada para a área de transferência como uma tabela Markdown formatada ou dados CSV, clique com o botão direito do mouse na tabela no Console e selecione a opção de cópia correspondente no menu de contexto.

undebug(function)

undebug(function) interrompe a depuração da função especificada para que, quando ela for chamada, o depurador não seja mais invocado. Isso é usado em conjunto com debug(fn).

undebug(getData);

unmonitor(function)

unmonitor(function) interrompe o monitoramento da função especificada. Isso é usado em conjunto com monitor(fn).

unmonitor(getData);

unmonitorEvents(object [, events])

unmonitorEvents(object[, events]) interrompe o monitoramento de eventos para o objeto e os eventos especificados. Por exemplo, o código a seguir interrompe todo o monitoramento de eventos no objeto window:

unmonitorEvents(window);

Também é possível interromper seletivamente o monitoramento de eventos específicos em um objeto. Por exemplo, o código a seguir começa a monitorar todos os eventos de mouse no elemento selecionado no momento e, em seguida, interrompe o monitoramento de eventos "mousemove" (talvez para reduzir o ruído na saída do console):

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

values(object)

values(object) retorna uma matriz que contém os valores de todas as propriedades que pertencem ao objeto especificado.

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

values(player);

Resultado de values(player).