Skip to content

Commit

Permalink
convert h2m to md
Browse files Browse the repository at this point in the history
  • Loading branch information
@fwqaaq @yin1999
fwqaaq authored and yin1999 committed Aug 1, 2022
1 parent a0d6e2f commit 50a698a
Show file tree
Hide file tree
Showing 5 changed files with 89 additions and 121 deletions.
32 changes: 14 additions & 18 deletions files/zh-cn/web/api/performanceobserver/disconnect/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3,22 +3,22 @@ title: PeformanceObserver.disconnect()
slug: Web/API/PerformanceObserver/disconnect
translation_of: Web/API/PerformanceObserver/disconnect
---
<div>{{APIRef("Performance Timeline API")}}</div>
{{APIRef("Performance Timeline API")}}

<div> </div>
{{domxref('PerformanceObserver')}} 接口的 **`disconnect()`** 方法用于阻止性能观察者接收任何 {{domxref("PerformanceEntry","性能条目", '', 'true')}} 事件。

<p>{{domxref('PerformanceObserver')}} 接口的 <strong><code>disconnect()</code></strong> 方法用于阻止性能观察者接收任何 {{domxref("PerformanceEntry","性能条目", '', 'true')}} 事件。</p>
## 语法

<h2 id="语法">语法</h2>
```js
performanceObserver.disconnect();
```

<pre class="syntaxbox"><em>performanceObserver</em>.disconnect();
</pre>
## 例子

<h2 id="例子">例子</h2>

<pre class="brush: js">var observer = new PerformanceObserver(function(list, obj) {
```js
var observer = new PerformanceObserver(function(list, obj) {
var entries = list.getEntries();
for (var i=0; i &lt; entries.length; i++) {
for (var i=0; i < entries.length; i++) {
// Process "mark" and "frame" events
}
});
Expand All @@ -32,16 +32,12 @@ function perf_observer(list, observer) {
}
var observer2 = new PerformanceObserver(perf_observer);
observer2.observe({entryTypes: ["measure"]});
</pre>
```

<h2 id="规范">规范</h2>
## 规范

{{Specifications}}

<h2 id="浏览器兼容性">浏览器兼容性</h2>

<div>

## 浏览器兼容性

<p>{{Compat("api.PerformanceObserver.disconnect")}}</p>
</div>
{{Compat}}
49 changes: 19 additions & 30 deletions files/zh-cn/web/api/performanceobserver/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,50 +8,39 @@ tags:
- 接口
translation_of: Web/API/PerformanceObserver
---
<div>{{APIRef("Performance Timeline API")}}</div>
{{APIRef("Performance Timeline API")}}

<div><strong><code>PerformanceObserver</code></strong> 用于监测性能度量事件，在浏览器的性能时间轴记录下一个新的 {{domxref("PerformanceEntry","performance entries", '', 'true')}} 的时候将会被通知 。</div>
**`PerformanceObserver`** 用于监测性能度量事件，在浏览器的性能时间轴记录下一个新的 {{domxref("PerformanceEntry","performance entries", '', 'true')}} 的时候将会被通知 。

{{AvailableInWorkers}}

## 构造函数

<div>{{AvailableInWorkers}}</div>
- {{domxref("PerformanceObserver.PerformanceObserver","PerformanceObserver()")}}
- : 创建并返回一个新的 `PerformanceObserver` 对象。

<h2 id="构造函数">构造函数</h2>
## 方法

<dl>
<dt>{{domxref("PerformanceObserver.PerformanceObserver","PerformanceObserver()")}}</dt>
<dd>创建并返回一个新的 <code>PerformanceObserver</code> 对象。</dd>
</dl>
- {{domxref("PerformanceObserver.observe","PerformanceObserver.observe()")}}
- : 指定监测的 {{domxref("PerformanceEntry.entryType","entry types")}} 的集合。 当 {{domxref("PerformanceEntry","performance entry")}} 被记录并且是指定的 `entryTypes` 之一的时候，性能观察者对象的回调函数会被调用。
- {{domxref("PerformanceObserver.disconnect","PerformanceObserver.disconnect()")}}
- : 性能监测回调停止接收 {{domxref("PerformanceEntry","性能条目", '', 'true')}}。

<h2 id="方法">方法</h2>
## 示例

<dl>
<dt>{{domxref("PerformanceObserver.observe","PerformanceObserver.observe()")}}</dt>
<dd>指定监测的 {{domxref("PerformanceEntry.entryType","entry types")}} 的集合。 当 {{domxref("PerformanceEntry","performance entry")}} 被记录并且是指定的 <code>entryTypes</code> 之一的时候，性能观察者对象的回调函数会被调用。</dd>
<dt>{{domxref("PerformanceObserver.disconnect","PerformanceObserver.disconnect()")}}</dt>
<dd>性能监测回调停止接收 {{domxref("PerformanceEntry","性能条目", '', 'true')}}。</dd>
</dl>

<dl>
</dl>

<h2 id="示例">示例</h2>

<pre class="brush: js">function perf_observer(list, observer) {
```js
function perf_observer(list, observer) {
// Process the "measure" event
// 处理 "measure" 事件
}
var observer2 = new PerformanceObserver(perf_observer);
observer2.observe({entryTypes: ["measure"]});</pre>
observer2.observe({entryTypes: ["measure"]});
```

<h2 id="规范">规范</h2>
## 规范

{{Specifications}}

<h2 id="浏览器兼容性">浏览器兼容性</h2>

<div>

## 浏览器兼容性

<p>{{Compat("api.PerformanceObserver")}}</p>
</div>
{{Compat}}
47 changes: 19 additions & 28 deletions files/zh-cn/web/api/performanceobserver/observe/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -7,41 +7,32 @@ tags:
- 接口
translation_of: Web/API/PerformanceObserver/observe
---
<div>{{APIRef("Performance Timeline API")}}</div>
{{APIRef("Performance Timeline API")}}

<p>{{domxref("PerformanceObserver", "性能监测对象")}} 的 <strong><code>observe()</code></strong> 方法用于观察传入的参数中指定的性能条目类型的集合。当记录一个指定类型的性能条目时，性能监测对象的回调函数将会被调用。</p>
{{domxref("PerformanceObserver", "性能监测对象")}} 的 **`observe()`** 方法用于观察传入的参数中指定的性能条目类型的集合。当记录一个指定类型的性能条目时，性能监测对象的回调函数将会被调用。

<h2 id="语法">语法</h2>
## 语法

<pre class="syntaxbox"><em>observer</em>.observe(<em>options</em>);
</pre>
```js
observer.observe(options);
```

<h3 id="参数">参数</h3>
### 参数

<p> </p>
- _options_
- : 一个只装了单个键值对的对象，该键值对的键名规定为 `entryTypes`。`entryTypes` 的取值要求如下：
- `entryTypes` 的值：一个放字符串的数组，字符串的有效值取值在{{domxref("PerformanceEntry.entryType", "性能条目类型")}} 中有详细列出。如果其中的某个字符串取的值无效，浏览器会自动忽略它。
- 另：若未传入 `options` 实参，或传入的 `options` 实参为空数组，会抛出 {{jsxref("TypeError")}}。

<dl>
<dt><em>options</em></dt>
<dd>一个只装了单个键值对的对象，该键值对的键名规定为 <code>entryTypes</code>。<code>entryTypes</code> 的取值要求如下：</dd>
</dl>
## 示例

<ul>
<li><code>entryTypes</code> 的值：一个放字符串的数组，字符串的有效值取值在{{domxref("PerformanceEntry.entryType", "性能条目类型")}} 中有详细列出。如果其中的某个字符串取的值无效，浏览器会自动忽略它。</li>
<li>另：若未传入 <code>options</code> 实参，或传入的 <code>options</code> 实参为空数组，会抛出 {{jsxref("TypeError")}}。</li>
</ul>

<dl>
<dt> </dt>
</dl>

<h2 id="示例">示例</h2>

<pre class="brush: js">/* 写法一 */
```js
/* 写法一 */

//直接往 PerformanceObserver() 入参匿名回调函数，成功 new 了一个 PerformanceObserver 类的，名为 observer 的对象
var observer = new PerformanceObserver(function(list, obj) {
var entries = list.getEntries();
for (var i=0; i &lt; entries.length; i++) {
for (var i=0; i < entries.length; i++) {
//处理 “mark” 和 “frame” 事件
}
});
Expand All @@ -58,12 +49,12 @@ function perf_observer(list, observer) {
var observer2 = new PerformanceObserver(perf_observer);
//调用 observer2 对象的 observe() 方法
observer2.observe({entryTypes: ["measure"]});
</pre>
```

<h2 id="规范">规范</h2>
## 规范

{{Specifications}}

<h2 id="浏览器兼容性">浏览器兼容性</h2>
## 浏览器兼容性

{{Compat("api.PerformanceObserver.observe")}}
{{Compat}}
42 changes: 19 additions & 23 deletions files/zh-cn/web/api/performanceobserver/performanceobserver/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3,31 +3,31 @@ title: PerformanceObserver()
slug: Web/API/PerformanceObserver/PerformanceObserver
translation_of: Web/API/PerformanceObserver/PerformanceObserver
---
<div>{{APIRef("Performance Timeline API")}}</div>
{{APIRef("Performance Timeline API")}}

<p><strong><code>PerformanceObserver()</code></strong> 构造函数使用给定的观察者 <code>callback</code> 生成一个新的 {{domxref("PerformanceObserver")}} 对象。当通过 {{domxref("PerformanceObserver.observe","observe()")}} 方法注册的 {{domxref("PerformanceEntry.entryType","条目类型",'','true')}} 的 {{domxref("PerformanceEntry","性能条目事件", '', 'true')}} 被记录下来时，调用该观察者回调. </p>
**`PerformanceObserver()`** 构造函数使用给定的观察者 `callback` 生成一个新的 {{domxref("PerformanceObserver")}} 对象。当通过 {{domxref("PerformanceObserver.observe","observe()")}} 方法注册的 {{domxref("PerformanceEntry.entryType","条目类型",'','true')}} 的 {{domxref("PerformanceEntry","性能条目事件", '', 'true')}} 被记录下来时，调用该观察者回调.

<h2 id="语法">语法</h2>
## 语法

<pre class="syntaxbox">var observer = new PerformanceObserver(<em>callback</em>);
</pre>
```js
var observer = new PerformanceObserver(callback);
```

<h3 id="参数">参数</h3>
### 参数

<dl>
<dt><em><code>callback</code></em></dt>
<dd>观察的性能事件被记录时将调用 <code>PerformanceObserverCallback</code> 回调。调用回调时，其第一个参数是 {{domxref("PerformanceObserverEntryList","性能观察条目列表", '', 'true')}}，第二个参数是 {{domxref("PerformanceObserver","观察者")}} 对象。</dd>
</dl>
- _`callback`_
- : 观察的性能事件被记录时将调用 `PerformanceObserverCallback` 回调。调用回调时，其第一个参数是 {{domxref("PerformanceObserverEntryList","性能观察条目列表", '', 'true')}}，第二个参数是 {{domxref("PerformanceObserver","观察者")}} 对象。

<h3 id="返回值">返回值</h3>
### 返回值

<p>一个在观察的性能事件发生时调用指定的 <code>callback</code> 的新 {{domxref("PerformanceObserver")}} 对象。</p>
一个在观察的性能事件发生时调用指定的 `callback` 的新 {{domxref("PerformanceObserver")}} 对象。

<h2 id="例子">例子</h2>
## 例子

<pre class="brush: js">var observer = new PerformanceObserver(function(list, obj) {
```js
var observer = new PerformanceObserver(function(list, obj) {
var entries = list.getEntries();
for (var i=0; i &lt; entries.length; i++) {
for (var i=0; i < entries.length; i++) {
// Process "mark" and "frame" events
}
});
Expand All @@ -38,16 +38,12 @@ function perf_observer(list, observer) {
}
var observer2 = new PerformanceObserver(perf_observer);
observer2.observe({entryTypes: ["measure"]});
</pre>
```

<h2 id="规范">规范</h2>
## 规范

{{Specifications}}

<h2 id="浏览器兼容性">浏览器兼容性</h2>
## 浏览器兼容性

<div>


<p>{{Compat("api.PerformanceObserver.PerformanceObserver")}}</p>
</div>
{{Compat}}
40 changes: 18 additions & 22 deletions files/zh-cn/web/api/performanceobserver/takerecords/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3,30 +3,30 @@ title: PerformanceObserver.takeRecords()
slug: Web/API/PerformanceObserver/takeRecords
translation_of: Web/API/PerformanceObserver/takeRecords
---
<div>{{APIRef("Performance Timeline API")}}</div>
{{APIRef("Performance Timeline API")}}

<div> </div>
{{domxref('PerformanceObserver')}} 接口的 **`takeRecords()`** 方法返回当前存储在性能观察器中的 {{domxref("PerformanceEntry","性能条目")}} 列表，将其清空。

<p>{{domxref('PerformanceObserver')}} 接口的 <strong><code>takeRecords()</code></strong> 方法返回当前存储在性能观察器中的 {{domxref("PerformanceEntry","性能条目")}} 列表，将其清空。</p>
## Syntax

<h2 id="Syntax">Syntax</h2>
```js
var PerformanceEntry[] = performanceObserver.takeRecords();
```

<pre class="syntaxbox">var PerformanceEntry[] = <em>performanceObserver</em>.takeRecords();
</pre>
### 参数

<h3 id="参数">参数</h3>
None.

<p>None.</p>
### 返回值

<h3 id="返回值">返回值</h3>
{{domxref("PerformanceEntry")}} 对象列表。

<p>{{domxref("PerformanceEntry")}} 对象列表。</p>
## 例子

<h2 id="例子">例子</h2>

<pre class="brush: js">var observer = new PerformanceObserver(function(list, obj) {
```js
var observer = new PerformanceObserver(function(list, obj) {
var entries = list.getEntries();
for (var i=0; i &lt; entries.length; i++) {
for (var i=0; i < entries.length; i++) {
// Process "mark" and "frame" events
}
});
Expand All @@ -35,16 +35,12 @@ var records = observer.takeRecords();
console.log(records[0].name);
console.log(records[0].startTime);
console.log(records[0].duration);
</pre>
```

<h2 id="规范">规范</h2>
## 规范

{{Specifications}}

<h2 id="浏览器兼容性">浏览器兼容性</h2>

<div>

## 浏览器兼容性

<p>{{Compat("api.PerformanceObserver.takeRecords")}}</p>
</div>
{{Compat}}

0 comments on commit 50a698a

Please sign in to comment.