克莱

使用research CLI命令

研究指挥部(npm运行研究)公开了有关WordPress性能研究的各种有用工具，例如使用WebPageTest。

本指南提供了有关如何使用可用命令的说明。此外，您可以使用npm运行研究--帮助以获取完整的CLI参考。

可用命令

注：所有命令都需要通过调用npm运行研究。下面的说明中将省略此前缀。

例如，当以下说明中的示例显示：

demo-command--演示论据是

要运行的完整命令是：

npm运行研究--演示命令--演示论据是

`wpt-指标`

获取的性能指标网页测试结果。

此命令分析WebPageTest结果数据中给定指标的中值。

默认情况下，只返回中值。您也可以选择请求所有单独的运行值。

论据

--测试(-t吨)：您需要传递WebPageTest结果ID（例如“221011_AiDcV7_GGM”）或URL（例如“https://www.webpagetest.org/result/221011_AiDcV7_GGM/“）。您可以选择传递多个测试结果ID以合并其度量。这通常不相关，但有助于将多个结果与类似的测试配置结合起来，从而有效地使测试运行次数超过WebPageTest规定的9的限制。
--指标(-米)：您需要通过一个或多个WebPageTest指标。“图形页面数据”视图上可用的任何指标（例如“https://www.webpagetest.org/graph_page_data.php？tests=221011_AiDcV7_GGM&median_value=1“）可用。有关完整列表，请参阅创建GetSingleMetricValue_（）中的函数库/wpt/result.mjs文件。此外，您可以通过前缀为“Server-Timing:”的标识符访问任何Server-Timing度量。您甚至可以通过添加将多个指标聚合到一个中(+)和/或减法(-)。确保算术运算符前后包含空格。
--格式(-（f）)：输出格式：“table”或“csv”。
--显示百分位数(-对)：是否显示更多颗粒百分位数，而不是仅显示中值。
--包括跑步(-我)：是否还显示所有运行的完整结果。
--行-列(-对)：是否反转行和列。

示例

获取第一个字节、第一次内容式绘制和最大内容式绘制的中间时间：

wpt-metrics--测试221011_AiDcV7_GGM--度量TTFB FCP LCP

同上，但结果格式为CSV：

wpt-metrics--测试221011_AiDcV7_GGM--度量TTFB FCP LCP--格式csv

获取第一字节时间、第一内容绘制和最大内容绘制的百分位值：

wpt-metrics--测试221011_AiDcV7_GGM--度量TTFB FCP LCP--显示百分比

获取第一字节中值的时间和所有单个运行值：

wpt-metrics--测试221011_AiDcV7_GGM--度量TTFB--包括运行

获取累计布局偏移中值和所有单独的运行值，行和列颠倒：

wpt-metrics--test 221011_AiDcV7_GGM--metrics CLS--include-runs--rows-as-columns

获取最大内容绘制与第一个字节的时间差的中值：

wpt-metrics--测试221011_AiDcV7_GGM--度量“LCP-TTFB”

获取名为“wp-before-template”的服务器计时指标的中值：

wpt-metrics--test 221011_AiDcV7_GGM--metrics服务器计时：wp-before-template

获取两个服务器计时指标“wp-before-template”和“wp-templates”之和的中值：

wpt-metrics--test 221011_AiDcV7_GGM--metrics“服务器计时：wp-before-template+服务器计时：wp-template”

`wp-服务器时间`

获取的服务器计时指标网页测试结果。

默认情况下，这些选项对于任何WebPageTest结果都不可用。只有当相应的页面被配置为发送服务器定时收割台。此命令从WebPageTest结果数据中分析所有可用的Server-Timing标头值。

默认情况下，只返回中值。您也可以选择请求所有单独的运行值。

论据

--测试(-t吨)：您需要传递WebPageTest结果ID（例如“221011_AiDcV7_GGM”）或URL（例如“https://www.webpagetest.org/result/221011_AiDcV7_GGM/“）。您可以选择传递多个测试结果ID以合并其度量。这通常不相关，但有助于将多个结果与类似的测试配置结合起来，从而有效地使测试运行次数超过WebPageTest规定的9的限制。
--格式(-（f）)：输出格式：“table”或“csv”。
--显示百分位数(-对)：是否显示更精细的百分位数，而不是仅显示中位数。
--包括跑步(-我)：是否还显示所有运行的完整结果。
--行-列(-对)：是否反转行和列。

示例

获取服务器计时标头中位数：

wp-服务器计时--测试221011_AiDcV7_GGM

同上，但结果格式为CSV：

wpt-server-timing--测试221011_AiDcV7_GGM--格式csv

获取服务器计时标头百分位值：

wpt-server-timing--测试221011_AiDcV7_GGM--显示百分比

获取服务器计时标头中位数和所有单个运行值：

wpt-server-timing--测试221011_AiDcV7_GGM--包括运行

`基准服务器定时`

将选定数量的具有特定并发性的请求发送到提供的URL，以找出每个URL的中间响应时间。它还跟踪响应中存在的任何服务器计时指标的中间值。

论据

--网址(-u个)：基准的URL。
--并发(-c（c）)：同时发出的请求数。
--数字(-n个)：要发送的请求总数。
--文件(-（f）)：使用URL（每行一个URL）运行基准测试的文件。
--输出(-o个)：输出格式：“table”或“csv”。
--显示百分位数(-对)：是否显示更多颗粒百分位数，而不是仅显示中值。

示例

发送10个请求，同时发送2个请求：

基准服务器计时--urlhttps://example.com/-n 10-c 2

同上，但结果格式为CSV：

基准服务器计时--urlhttps://example.com/-n 10-c 2--输出csv

要包含更多的颗粒百分位数，而不仅仅是每个指标的中位数：

基准服务器计时--urlhttps://example.com网站/-n 10-c 2--显示百分位数

要对文件中的URL运行基准测试，请执行以下操作：

基准-服务器计时-f路径/to/urls.txt-n 5

`基准-关键点`

在无头浏览器中多次加载提供的URL，以测量每个URL的中位数Web重要指标。目前，结果包括加载时间指标FCP、LCP和TTFB，以及聚合指标“LCP-TTFB”，这对于专门评估客户端性能非常有用。在跟进拉动请求.

论据

--网址(-u个)：基准的URL。
--数字(-n个)：要发送的请求总数。
--文件(-（f）)：使用URL（每行一个URL）运行基准测试的文件。
--指标(-米)：要包括哪些指标；默认情况下，这些是“FCP”、“LCP”、”TTFB“和”LCP-TTFB”。
--输出(-o个)：输出格式：“table”或“csv”。
--显示百分位数(-对)：是否显示更多颗粒百分位数，而不是仅显示中值。
--节流式聚氨酯(-t吨)：启用CPU调节以模拟速度较慢的CPU。
--网络条件(-c（c）)：启用网络条件模拟（可以是“慢速3G”或“快速3G”）。

示例

向单个URL发送10个请求：

基准-重要信息--urlhttps://example.com/-n 10个

同上，但结果格式为CSV：

基准-重要信息--urlhttps://example.com/-n 10—输出csv

要包括一组不同的（子）指标（例如“TTFB”和“LCP-TTFB“）：

基准-重要信息--urlhttps://example.com/-n 10--度量TTFB"LCP-tfb型"

包括自定义服务器计时度量，如wp-total公司（仅当在服务器上配置时）：

基准-重要信息--urlhttps://example.com/-n 10--指标ST:wp-total

要包含更多的颗粒百分位数，而不仅仅是每个指标的中位数：

基准-重要信息--urlhttps://example.com/-n 10--显示百分位数

要对文件中的URL运行基准测试，请执行以下操作：

基准web-vitals-f路径/to/urls.txt-n 5

要在模拟Fast 3G网络条件的同时发出限制CPU 4x的请求，请执行以下操作：

基准-重要信息--urlhttps://example.com/-t 4-c"快速3G"

`分析负荷优化`

使用桌面和移动模拟加载给定的URL，并收集有关其元素的加载优化程度的信息，例如LCP映像是否fetchpriority=高以及初始视口中是否有加载延迟的图像。

论据

--网址(-u个)：要分析的URL。
--输出(-o个)：输出格式，可以是“table”、“json”、“csv”或“csv-oneline”。

示例

分析WordPress.org的加载优化问题，并将信息显示在表中（如果脑脊液病毒使用）：

分析-负荷-优化---uhttps://wordpress.org/-o表格╔══════════════════════════════╤════════╤═════════╗║ 字段│ 移动的│ 桌面║╟──────────────────────────────┼────────┼─────────╢║ lcp公制│ 991.5│ 620.5║╟──────────────────────────────┼────────┼─────────╢║ lcp元素│ H1型│ IMG公司║╟──────────────────────────────┼────────┼─────────╢║ lcpElementIsLazy已加载│假│假║╟──────────────────────────────┼────────┼─────────╢║ lcp图像丢失获取优先级│假│真的║╟──────────────────────────────┼────────┼─────────╢║ 获取优先级计数│ 0│ 0║╟──────────────────────────────┼────────┼─────────╢║ fetchPriorityInsideViewport│ 0│ 0║╟──────────────────────────────┼────────┼─────────╢║ 获取优先级外部视口│ 0│ 0║╟──────────────────────────────┼────────┼─────────╢║ 惰性可加载计数│ 14│ 14║╟──────────────────────────────┼────────┼─────────╢║ lazyLoadedInsideViewport│ 0│ 0║╟──────────────────────────────┼────────┼─────────╢║ lazyLoadedOutsideViewport（延迟加载的外部视口）│ 0│ 0║╟──────────────────────────────┼────────┼─────────╢║ 期望加载的内部视口│ 0│ 0║╟──────────────────────────────┼────────┼─────────╢║ eagerLoadedOutsideViewport（加载的外部视口）│ 14│ 14║———————————————————————————————————————————————————————————————————————————————————————————————————————————║ 错误│ 14│ 15║╚══════════════════════════════╧════════╧═════════╝

同上，但结果格式为JSON，其中包括底层错误代码：

分析-负荷-优化---uhttps://wordpress.org/-o杰森{"网址":"https://wordpress.org/","设备分析": {"可移动的": {"lcp公制": 1122.3999999761581,"lcp元素":"上半年","lcpElementIsLazy已加载"：false，"lcp图像丢失获取优先级"：false，"获取优先级计数": 0,"fetchPriorityInsideViewport": 0,"获取优先级外部视口": 0,"惰性可加载计数": 14,"lazyLoadedInsideViewport空闲加载的内部视口": 0,"lazyLoadedOutsideViewport（延迟加载的外部视口）": 0,"期望加载的内部视口": 0,"eagerLoadedOutsideViewport（加载的外部视口）": 14,"错误": ["EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）"]}，"桌面": {"lcp公制": 502,"lcp元素":"IMG公司","lcpElementIsLazy已加载"：false，"lcp图像丢失获取优先级"：true，"获取优先级计数": 0,"fetchPriorityInsideViewport": 0,"获取优先级外部视口": 0,"惰性可加载计数": 14,"lazyLoadedInsideViewport"：0，"lazyLoadedOutsideViewport（延迟加载的外部视口）": 0,"期望加载的内部视口": 0,"eagerLoadedOutsideViewport（加载的外部视口）": 14,"错误": ["LCP_IMAGE_MISSING_FETCHPRIORITY公司","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）","EAGER_LOADED_ELEMENT_OUTSIDE_INITIAL_VIEWPORT（EAGER_加载_元素_外部_初始_视图端口）"]}}}

还有一个csv单线格式，用于排序一组URL的结果。例如，给定一个文件网址.txt:

https://wordpress.org/https://make.wordpress.org/https://wptavern.com/

并给出了Bash脚本批分析加载优化.sh:

#!/垃圾桶/垃圾桶url_count=0虽然 阅读网址; 做
	回声 "$url_count（美元）.$网址" >/开发/标准错误如果npm运行--静默研究分析-优化--u"$网址"-o csv单线|尾部-n$([[$url_count（美元） =0]]&& 回声2|| 回声1); 然后url _计数=$(($url_count（美元） + 1 ))
	fi（菲涅耳）
完成

运行此命令：

猫网址.txt|./批处理分析加载优化.sh>分析仪.csv

结果是分析软件包含以下内容的文件：

url，mobile:lcpMetric，mobile:lcpElement，mobile，移动：lcpElementIsLazyLoaded，mobile_:lcpImageMissingFetchPriority，移动：fetchPriorityCount，移动：FetchPritityInsideViewport，移动：获取优先级OutsideViewport，mobile:eagerLoadedOutsideViewport，mobile:错误，desktop:lcpMetric，desktop：lcpElement，desktop:lcpElementIsLazyLoaded，desktup:lcpImageMissingFetchPriority，desktom:fetchPriorityCount，desktor:fetchPriorityInsideViewport，桌面：eagerLoadedInsideViewport，桌面：eakerLoadedOutsideViewport、桌面：错误https://wordpress.org/，917.4，IMG，假，真，0,0,0,14,0,0，0,14,15659.8，IMGhttps://make.wordpress.org/，926.6，IMG，假，假，1,1,0,3,0,0,1,2,2650.1，IMGhttps://wptavern.com/，996.5，IMG，真，真，0,0,0,12,2,8,0,2,6722.5，IMG

例如，可以将其粘贴到Google Sheet中进行进一步分析。

姓名		姓名	上次提交消息	上次提交日期
父目录 ..
命令		命令
自由		自由
自述.md		自述.md
运行.mjs		运行.mjs

提供反馈

保存的搜索

使用保存的搜索更快地筛选结果

克莱

克莱

命令

命令

自由

自由

自述.md

自述.md

运行.mjs

运行.mjs

自述.md

使用research CLI命令

可用命令

`wpt-指标`

论据

示例

`wp-服务器时间`

论据

示例

`基准服务器定时`

论据

示例

`基准-关键点`

论据

示例

`分析负荷优化`

论据

示例

文件夹

克莱

目录操作

更多选项

目录操作

更多选项

最新提交

历史

克莱

文件夹和文件

父目录

使用research CLI命令

可用命令

wpt-指标

论据

示例

wp-服务器时间

论据

示例

基准服务器定时

论据

示例

基准-关键点

论据

示例

分析负荷优化

论据

示例

`wpt-指标`

`wp-服务器时间`

`基准服务器定时`

`基准-关键点`

`分析负荷优化`