initial commit

1 files changed, 178 insertions, 0 deletions

diff --git a/files/zh-cn/web/api/performanceentry/name/index.html b/files/zh-cn/web/api/performanceentry/name/index.html
new file mode 100644
index 0000000000..a12b1c4c67
--- /dev/null
+++ b/files/zh-cn/web/api/performanceentry/name/index.html
@@ -0,0 +1,178 @@
+---
+title: PerformanceEntry.name
+slug: Web/API/PerformanceEntry/name
+translation_of: Web/API/PerformanceEntry/name
+---
+<div>{{APIRef("Performance Timeline API")}}</div>
+
+<p><span class="seoSummary"><strong><code>name 是</code></strong> {{domxref("PerformanceEntry")}} 接口的属性，此属性的返回值是 {{domxref("PerformanceEntry.entryType")}} 的返回值的一个补充，例如entry.entryType="navigation",entry.name="document". 这是一个只读属性.</span></p>
+
+<h2 id="Syntax" name="Syntax">Syntax</h2>
+
+<pre class="syntaxbox">var<em> name</em> = <em>entry</em>.name;
+</pre>
+
+<h3 id="Return_Value" name="Return_Value">返回值</h3>
+
+<p>返回值取决于<code>PerformanceEntry</code> 对象的 subtype和{{domxref("PerformanceEntry.entryType")}}的值, 如下表所示.</p>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">Value</th>
+   <th scope="col">Subtype</th>
+   <th scope="col">entryType values</th>
+   <th scope="col">Description</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{domxref("URL")}}</td>
+   <td>{{domxref('PerformanceFrameTiming')}}, {{domxref('PerformanceNavigationTiming')}}</td>
+   <td><code>frame</code>, <code>navigation</code></td>
+   <td>The document's address.</td>
+  </tr>
+  <tr>
+   <td>{{domxref("URL")}}</td>
+   <td>{{domxref('PerformanceResourceTiming')}}</td>
+   <td><code>resource</code></td>
+   <td>The resolved URL of the requested resource. This value doesn't change even if the request is redirected.</td>
+  </tr>
+  <tr>
+   <td>{{domxref("DOMString")}}</td>
+   <td>{{domxref('PerformanceMark')}}</td>
+   <td><code>mark</code></td>
+   <td>The name used when the mark was created by calling {{domxref("Performance.mark","performance.mark()")}}.</td>
+  </tr>
+  <tr>
+   <td>{{domxref("DOMString")}}</td>
+   <td>{{domxref('PerformanceMeasure')}}</td>
+   <td><code>measure</code></td>
+   <td>name used when the measure was created by calling {{domxref("Performance.measure","performance.measure()")}}.</td>
+  </tr>
+  <tr>
+   <td>{{domxref("DOMString")}}</td>
+   <td>{{domxref('PerformancePaintTiming')}}</td>
+   <td><code>paint</code></td>
+   <td>Either <code>'first-paint'</code> or <code>'first-contentful-paint'</code>.</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="用例">用例</h2>
+
+<p>下面的例子是 <code>name</code> 属性的用法.</p>
+
+<pre class="brush: js">function run_PerformanceEntry() {
+  log("PerformanceEntry support ...");
+
+  if (performance.mark === undefined) {
+    log("... performance.mark Not supported");
+    return;
+  }
+
+  // Create some performance entries via the mark() method
+  performance.mark("Begin");
+  do_work(50000);
+  performance.mark("End");
+
+  // Use getEntries() to iterate through the each entry
+  var p = performance.getEntries();
+  for (var i=0; i &lt; p.length; i++) {
+    log("Entry[" + i + "]");
+    check_PerformanceEntry(p[i]);
+  }
+}
+  //
+  //例如上面p中一个entry p[0] = {
+  //  "name": "document",
+  //  "entryType": "navigation",
+  //  "startTime": 0,
+  //  "duration": 3611.26,
+  //  "initiatorType": "navigation",
+  //  "nextHopProtocol": "http/1.1",
+  //  "workerStart": 0,
+  //  "redirectStart": 0,
+  //  "redirectEnd": 0,
+  //  "fetchStart": 0.32,
+  //  "domainLookupStart": 17.64,
+  //  "domainLookupEnd": 17.78,
+  //  "connectStart": 17.86,
+  //  "connectEnd": 18.1,
+  //  "secureConnectionStart": 0,
+  //  "requestStart": 18.3,
+  //  "responseStart": 294.06,
+  //  "responseEnd": 1610.3600000000001,
+  //  "transferSize": 97683,
+  //  "encodedBodySize": 97112,
+  //  "decodedBodySize": 97112,
+  //  "unloadEventStart": 1614.8372840721554,
+  //  "unloadEventEnd": 1619.1600105887128,
+  //  "domInteractive": 3110.767514889843,
+  //  "domContentLoadedEventStart": 3125.859851800787,
+  //  "domContentLoadedEventEnd": 3438.5779820633365,
+  //  "domComplete": 3609.999662153349,
+  //  "loadEventStart": 3610.017623620869,
+  //  "loadEventEnd": 3611.2672285754975,
+  //  "type": "reload",
+  //  "redirectCount": 0
+  //}
+
+  //下面的函数check_PerformanceEntry的参数obj就是上面的p[0]
+  //
+function check_PerformanceEntry(obj) {
+  var properties = ["name", "entryType", "startTime", "duration"];
+  var methods = ["toJSON"];
+
+  for (var i=0; i &lt; properties.length; i++) {
+    // check each property
+    var supported = properties[i] in obj;
+    if (supported)
+      log("..." + properties[i] + " = " + obj[properties[i]]);
+    else
+      log("..." + properties[i] + " = Not supported");
+  }
+  for (var i=0; i &lt; methods.length; i++) {
+    // check each method
+    var supported = typeof obj[methods[i]] == "function";
+    if (supported) {
+      var js = obj[methods[i]]();
+      log("..." + methods[i] + "() = " + JSON.stringify(js));
+    } else {
+      log("..." + methods[i] + " = Not supported");
+    }
+  }
+}
+</pre>
+
+<h2 id="Specifications">Specifications</h2>
+
+<table class="standard-table">
+ <tbody>
+  <tr>
+   <th scope="col">Specification</th>
+   <th scope="col">Status</th>
+   <th scope="col">Comment</th>
+  </tr>
+  <tr>
+   <td>{{SpecName('Performance Timeline Level 2', '#dom-performanceentry-name', 'name')}}</td>
+   <td>{{Spec2('Performance Timeline Level 2')}}</td>
+   <td> </td>
+  </tr>
+  <tr>
+   <td>{{SpecName('Performance Timeline', '#dom-performanceentry-name', 'name')}}</td>
+   <td>{{Spec2('Performance Timeline')}}</td>
+   <td>Initial definition.</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility">Browser compatibility</h2>
+
+<div>
+<div>
+
+
+<p>{{Compat("api.PerformanceEntry.name")}}</p>
+</div>
+</div>