此页面由 Cloud Translation API 翻译。

Console Utilities API 参考文档

Kayce Basques

Sofia Emelianova

Console Utilities API 包含一个用于执行以下常见任务的便捷函数集合：选择和检查 DOM 元素、查询对象、以可读格式显示数据、停止和启动分析器、监控 DOM 事件和函数调用等。

在找 console.log()、console.error() 和其他 console.* 函数？请参阅 Console API 参考文档。

$_

$_ 会返回最近评估的表达式的值。

在以下示例中，对一个简单的表达式 (2 + 2) 进行评估。然后评估 $_ 属性，其包含相同的值：

$_ 是最近评估的表达式。

在下一个示例中，已评估的表达式最初包含一个名称数组。评估 $_.length 以发现数组的长度，$_ 中存储的值变为最新评估的表达式，即 4：

$_ 在评估新命令时会发生变化。

$0 - $4

$0、$1、$2、$3 和 $4 命令可用作对 Elements 面板中最后检查的五个 DOM 元素或 Profiles 面板中最后选择的五个 JavaScript 堆对象的历史引用。$0 会返回最近选择的元素或 JavaScript 对象，$1 会返回最近选择的第二个元素，依此类推。

在以下示例中，在 Elements 面板中选择了 img 元素。在 Console 抽屉式导航栏中，$0 已评估，并显示相同的元素：

示例：$0。

下图显示的是在同一个页面中选择的一个不同的元素。$0 现在指的是新选择的元素，而 $1 返回以前选择的元素：

示例：$1。

$(selector [, startNode])

$(selector) 会返回带有指定 CSS 选择器的第一个 DOM 元素的引用。使用一个参数调用此函数时，此函数是 document.querySelector() 函数的快捷方式。

以下示例返回文档中第一个 <img> 元素的引用：

$('img') 的示例。

右键点击返回的结果，然后选择 Reveal in Elements Panel 以在 DOM 中查找它，或选择 Scroll in to View 以在页面上显示它。

以下示例返回当前选择的元素的引用，并显示它的 src 属性：

$('img').src 示例。

此函数还支持第二个参数 startNode，用于指定要从中搜索元素的“元素”或节点。此参数的默认值为 document。

以下示例返回 devsite-header-background 的第一个子元素 img 的引用，并显示其 src 属性：

$('img', div).src 的示例。

注意：如果您在使用库，例如，使用 $ 的 jQuery，则此功能将被覆盖，$ 将与该库的实现对应。

$$(selector [, startNode])

$$(selector) 会返回与给定 CSS 选择器匹配的元素数组。此命令等同于调用 Array.from(document.querySelectorAll())。



以下示例使用 $$() 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);
}
在所选节点后面当前文档中显示的 <img> 元素：
let images = $$('img', document.querySelector('.devsite-header-background'));
for (let each of images) {
  console.log(each.src);
}



注意：在控制台中按 Shift + Enter 键以开始一个新行，无需执行脚本。

$x(path [, startNode])

$x(path) 返回一个与给定 XPath 表达式匹配的 DOM 元素数组。

例如，以下代码会返回页面上的所有 <p> 元素：
$x("//p")



以下示例会返回包含 <a> 元素的所有 <p> 元素：
$x("//p[a]")



与其他选择器函数类似，$x(path) 有一个可选的第二个参数 startNode，用于指定要从中搜索元素的元素或节点。



clear()

clear() 清除其历史记录的控制台。
clear();

copy(object)

copy(object) 将指定对象的字符串表示形式复制到剪贴板。
copy($0);

debug(function)

调用指定的函数时，将触发调试程序，并在 Sources 面板上使函数内部中断，从而允许逐行执行代码并进行调试。
debug(getData);



使用 undebug(fn) 停止函数中断，或使用界面停用所有断点。

如需详细了解断点，请参阅使用断点暂停代码。

dir(object)

dir(object) 会显示所有指定对象的属性的对象样式列表。此方法是 Console API 的 console.dir() 方法的快捷方式。

以下示例展示了直接在命令行中评估 document.body 和使用 dir() 显示相同元素之间的差异：
document.body;
dir(document.body);



如需了解详情，请参阅 Console API 中的 console.dir() 条目。

dirxml(object)

dirxml(object) 会输出以 XML 形式表示的指定对象，如 Elements 面板中所示。此方法等同于 console.dirxml() 方法。

inspect(object/function)

inspect(object/function) 在相应的面板中打开并选择指定的元素或对象：针对 DOM 元素使用 Elements 面板，或针对 JavaScript 堆对象使用 Profiles 面板。

以下示例会在 Elements 面板中打开 document.body：
inspect(document.body);



当传递要检查的函数时，此函数会在 Sources 面板中打开文档以供您检查。

getEventListeners(object)

getEventListeners(object) 会返回在指定对象上注册的事件监听器。返回值是一个对象，其中包含每个已注册事件类型（例如 click 或 keydown）对应的数组。每个数组的成员都是描述为每种类型注册的监听器的对象。例如，以下代码会列出在文档对象上注册的所有事件监听器：
getEventListeners(document);



如果在指定对象上注册了多个监听器，则数组包含每个监听器的成员。在以下示例中，在文档元素上为 click 事件注册了两个事件监听器：



您可以进一步展开每个对象以查看它们的属性：



如需了解详情，请参阅检查对象属性。

keys(object)

keys(object) 返回一个数组，其中包含属于指定对象的属性名称。如需获取相同属性的关联值，请使用 values()。

例如，假设您的应用定义了以下对象：
let player = {
    "name": "Parzival",
    "number": 1,
    "state": "ready",
    "easterEggs": 3
};

假设在全局命名空间中定义了 player（为简单起见），那么，在控制台中输入 keys(player) 和 values(player) 会生成以下内容：



monitor(function)

调用指定函数时，系统会向控制台记录一条消息，其中指明函数名称及在调用时传递到该函数的参数。
function sum(x, y) {
  return x + y;
}
monitor(sum);



使用 unmonitor(function) 停止监控。

monitorEvents(object [, events])

当在指定对象上发生一个指定事件时，将 Event 对象记录到控制台。您可以指定一个要监控的单独事件、一个事件数组或一个映射到预定义事件集合的常规事件“类型”。请参阅下面的示例。

以下事件监控 window 对象上的所有调整事件。
monitorEvents(window, "resize");



下面定义一个在 window 对象上同时监控“resize”和“scroll”事件的数组：
monitorEvents(window, ["resize", "scroll"])

您还可以指定一个可用的事件“类型”、映射到预定义事件集的字符串。下表列出了可用的事件类型及其相关的事件映射：

事件类型和对应的已映射事件
老鼠 “mousedown”“mouseup”“click”“dblclick”“mousemove”“mouseover”“mouseout”“mousewheel”
键 “keydown”“keyup”“keypress”“textInput”
触控输入 “touchstart”“touchmove”“touchend”“touchcancel”
对照组 “resize”“scroll”“zoom”“focus”“blur”“select”“change”“submit”“reset”

例如，以下示例为 Elements 面板上当前选择的输入文本字段上的所有对应 key 事件使用使用“key”事件类型。
monitorEvents($0, "key");

下面是在文本字段中输入字符后的一个输出示例：



使用 unmonitorEvents(object[, events]) 停止监控。

profile([name]) and profileEnd([name])

profile() 使用可选的名称启动一个 JavaScript CPU 分析会话。profileEnd() 会完成配置文件，并在效果 > 主要轨道中显示结果。

注意：profile() 和 profileEnd() 是 console.profile() 和 console.profileEnd() 的缩写。

如需开始分析，请按以下步骤操作：
profile("Profile 1")

如需停止分析并在性能 > 主要轨道中查看结果，请执行以下操作：
profileEnd("Profile 1")

在效果 > 主要轨道中查看结果：



也可以嵌套配置文件。例如，这在任意顺序下都起作用：
profile('A');
profile('B');
profileEnd('A');
profileEnd('B');

注意：一次可运行多个 CPU 配置文件，不需要您按创建顺序结束它们。

queryObjects(Constructor)

从控制台中调用 queryObjects(Constructor) 可返回使用指定构造函数创建的对象数组。例如：


queryObjects(Promise)。返回 Promise 的所有实例。
queryObjects(HTMLElement)。返回所有 HTML 元素。
queryObjects(foo)，其中 foo 是类名称。返回通过 new foo() 实例化的所有对象。


queryObjects() 的范围是控制台中当前所选的执行上下文。

table(data [, columns])

通过传入含可选列标题的数据对象记录具有表格格式的对象数据。
这是 console.table() 的快捷方式。

例如，如需在控制台中显示使用 table 的名称列表，您需要执行以下操作：
let names = [
  { firstName: "John", lastName: "Smith" },
  { firstName: "Jane", lastName: "Doe" },
];
table(names);



undebug(function)

undebug(function) 可停止调试指定函数，以便在调用函数时，不再调用调试程序。此属性与 debug(fn) 搭配使用。
undebug(getData);

unmonitor(function)

unmonitor(function) 可停止监控指定函数。此属性与 monitor(fn) 搭配使用。
unmonitor(getData);

unmonitorEvents(object [, events])

unmonitorEvents(object[, events]) 会停止针对指定对象和事件监控事件。例如，以下命令可停止 window 对象上的所有事件监控：
unmonitorEvents(window);

您也可以有选择地停止监控某个对象上的特定事件。例如，以下代码可开始对当前所选元素上所有鼠标事件的监控，然后停止监控“mousemove”事件（可能会减少控制台输出的噪音）：
monitorEvents($0, "mouse");
unmonitorEvents($0, "mousemove");

values(object)

values(object) 会返回一个数组，其中包含属于指定对象的所有属性值。
let player = {
    "name": "Parzival",
    "number": 1,
    "state": "ready",
    "easterEggs": 3
};

values(player);

事件类型和对应的已映射事件
老鼠	“mousedown”“mouseup”“click”“dblclick”“mousemove”“mouseover”“mouseout”“mousewheel”
键	“keydown”“keyup”“keypress”“textInput”
触控输入	“touchstart”“touchmove”“touchend”“touchcancel”
对照组	“resize”“scroll”“zoom”“focus”“blur”“select”“change”“submit”“reset”