From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../web/api/performanceentry/duration/index.html | 116 ++++++++++++++++ .../web/api/performanceentry/entrytype/index.html | 125 +++++++++++++++++ files/ja/web/api/performanceentry/index.html | 149 +++++++++++++++++++++ files/ja/web/api/performanceentry/name/index.html | 146 ++++++++++++++++++++ .../web/api/performanceentry/starttime/index.html | 116 ++++++++++++++++ .../ja/web/api/performanceentry/tojson/index.html | 108 +++++++++++++++ 6 files changed, 760 insertions(+) create mode 100644 files/ja/web/api/performanceentry/duration/index.html create mode 100644 files/ja/web/api/performanceentry/entrytype/index.html create mode 100644 files/ja/web/api/performanceentry/index.html create mode 100644 files/ja/web/api/performanceentry/name/index.html create mode 100644 files/ja/web/api/performanceentry/starttime/index.html create mode 100644 files/ja/web/api/performanceentry/tojson/index.html (limited to 'files/ja/web/api/performanceentry') diff --git a/files/ja/web/api/performanceentry/duration/index.html b/files/ja/web/api/performanceentry/duration/index.html new file mode 100644 index 0000000000..48a956d855 --- /dev/null +++ b/files/ja/web/api/performanceentry/duration/index.html @@ -0,0 +1,116 @@ +--- +title: PerformanceEntry.duration +slug: Web/API/PerformanceEntry/duration +tags: + - API + - Web パフォーマンス + - プロパティ + - リファレンス +translation_of: Web/API/PerformanceEntry/duration +--- +
{{APIRef("Performance Timeline API")}}
+ +

duration プロパティは、{{domxref("PerformanceEntry","パフォーマンスエントリ")}}の期間である{{domxref("DOMHighResTimeStamp","タイムスタンプ")}}を返します。

+ +

{{AvailableInWorkers}}

+ +

このプロパティによって返される値は、パフォーマンスエントリの{{domxref("PerformanceEntry.entryType","タイプ")}}によって異なります。

+ + + +

このプロパティは {{readonlyInline}} です。

+ +

構文

+ +
entry.duration;
+ +

戻り値

+ +

{{domxref("PerformanceEntry","パフォーマンスエントリ")}}の長さを表す {{domxref("DOMHighResTimeStamp")}}。期間の概念が特定のパフォーマンスメトリックに適用されない場合、ブラウザは期間 0 を返すように選択することがあります。

+ +

メモ: パフォーマンスエントリが "resource" の {{domxref("PerformanceEntry.entryType","entryType")}} を持つ場合 (つまり、エントリが {{domxref("PerformanceResourceTiming")}} オブジェクトである場合)、このプロパティは {{domxref("PerformanceEntry.responseEnd")}} と {{domxref("PerformanceEntry.startTime")}} の差の{{domxref("DOMHighResTimeStamp","タイムスタンプ")}}を返します。

+ +

例

+ +

次の例は、duration プロパティの使用方法を示しています。

+ +
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 < p.length; i++) {
+    log("Entry[" + i + "]");
+    check_PerformanceEntry(p[i]);
+  }
+}
+function check_PerformanceEntry(obj) {
+  var properties = ["name", "entryType", "startTime", "duration"];
+  var methods = ["toJSON"];
+
+  for (var i=0; i < 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 < 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");
+    }
+  }
+}
+
+ +

仕様

+ + + + + + + + + + + + + + + + + + + +
仕様書ステータスコメント
{{SpecName('Performance Timeline Level 2', '#dom-performanceentry-duration', 'duration')}}{{Spec2('Performance Timeline Level 2')}} 
{{SpecName('Performance Timeline', '#dom-performanceentry-duration', 'duration')}}{{Spec2('Performance Timeline')}}初期定義
+ +

ブラウザの互換性

+ +
+ + +

{{Compat("api.PerformanceEntry.duration")}}

+
diff --git a/files/ja/web/api/performanceentry/entrytype/index.html b/files/ja/web/api/performanceentry/entrytype/index.html new file mode 100644 index 0000000000..2a8e0a4cde --- /dev/null +++ b/files/ja/web/api/performanceentry/entrytype/index.html @@ -0,0 +1,125 @@ +--- +title: PerformanceEntry.entryType +slug: Web/API/PerformanceEntry/entryType +tags: + - API + - PerformanceEntry + - Web パフォーマンス + - パフォーマンスタイムライン API + - プロパティ + - リファレンス +translation_of: Web/API/PerformanceEntry/entryType +--- +
{{APIRef("Performance Timeline API")}}
+ +

entryType プロパティは、たとえば "mark" などのパフォーマンスメトリックの種類を表す {{domxref("DOMString")}} を返します。このプロパティは読み取り専用です。

+ +

{{AvailableInWorkers}}

+ +

構文

+ +
var type = entry.entryType;
+ +

戻り値

+ +

戻り値は PerformanceEntry オブジェクトのサブタイプに依存し、次の表に示すように {{domxref('PerformanceEntry.name')}} プロパティの値に影響します。

+ +

パフォーマンスエントリタイプの名前

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
値サブタイプname プロパティのタイプname プロパティの説明
frame, navigation{{domxref('PerformanceFrameTiming')}}, {{domxref('PerformanceNavigationTiming')}}{{domxref("URL")}}ドキュメントのアドレス
resource{{domxref('PerformanceResourceTiming')}}{{domxref("URL")}}リクエストされたリソースの解決された URL。リクエストがリダイレクトされても、この値は変わりません。
mark{{domxref('PerformanceMark')}}{{domxref("DOMString")}}{{domxref("Performance.mark","performance.mark()")}} を呼び出してマークを作成したときに使用された名前
measure{{domxref('PerformanceMeasure')}}{{domxref("DOMString")}}メジャーが {{domxref("Performance.measure","performance.measure()")}} を呼び出して作成されたときに使用された名前
paint{{domxref('PerformancePaintTiming')}}{{domxref("DOMString")}}'first-paint' もしくは 'first-contentful-paint' のいずれか
+ +

例

+ +

次の例は、entryType プロパティの使用方法を示しています。

+ +
function run_PerformanceEntry() {
+
+  // check for feature support before continuing
+  if (performance.mark === undefined) {
+    console.log("performance.mark not supported");
+    return;
+  }
+
+  // Create a performance entry named "begin" via the mark() method
+  performance.mark("begin");
+
+  // Check the entryType of all the "begin" entries
+  var entriesNamedBegin = performance.getEntriesByName("begin");
+	for (var i=0; i < entriesNamedBegin.length; i++) {
+      var typeOfEntry = entriesNamedBegin[i].entryType;
+      console.log("Entry is type: " + typeOfEntry);
+  }
+
+}
+
+ +

仕様

+ + + + + + + + + + + + + + + + + + + +
仕様書ステータスコメント
{{SpecName('Performance Timeline Level 2', '#dom-performanceentry-entrytype', 'entryType')}}{{Spec2('Performance Timeline Level 2')}} 
{{SpecName('Performance Timeline', '#dom-performanceentry-entrytype', 'entryType')}}{{Spec2('Performance Timeline')}}初期定義
+ +

ブラウザの互換性

+ +
+ + +

{{Compat("api.PerformanceEntry.entryType")}}

+
diff --git a/files/ja/web/api/performanceentry/index.html b/files/ja/web/api/performanceentry/index.html new file mode 100644 index 0000000000..da7c5949a2 --- /dev/null +++ b/files/ja/web/api/performanceentry/index.html @@ -0,0 +1,149 @@ +--- +title: PerformanceEntry +slug: Web/API/PerformanceEntry +tags: + - API + - PerformanceEntry + - Web パフォーマンス + - インターフェイス + - パフォーマンスタイムライン API + - リファレンス +translation_of: Web/API/PerformanceEntry +--- +
{{APIRef("Performance Timeline API")}}
+ +

PerformanceEntry オブジェクトは、パフォーマンスタイムラインの一部である単一のパフォーマンスメトリックをカプセル化します。パフォーマンスエントリは、アプリケーション内の明示的な時点でパフォーマンス {{domxref("PerformanceMark","mark")}} または {{domxref("PerformanceMeasure","measure")}} を作成する (たとえば、{{domxref("Performance.mark","mark()")}} メソッドを呼び出すことによって) ことで直接作成できます。パフォーマンスエントリは、(イメージなどの) リソースのロードなどの間接的な方法でも作成されます。

+ +

PerformanceEntry インスタンスは常に次のサブタイプのいずれかになります:

+ + + +

{{AvailableInWorkers}}

+ +

プロパティ

+ +
+
{{domxref("PerformanceEntry.name")}} {{readonlyInline}}
+
{{domxref("PerformanceEntry.entryType")}} プロパティによって返される値をさらに指定する値。両方の値はサブタイプによって異なります。有効な値についてはプロパティページを参照してください。
+
{{domxref("PerformanceEntry.entryType")}} {{readonlyInline}}
+
たとえば、"mark" などのパフォーマンスメトリックの種類を表す {{domxref("DOMString")}}。有効な値についてはプロパティページを参照してください。
+
{{domxref("PerformanceEntry.startTime")}} {{readonlyInline}}
+
パフォーマンスメトリックの開始時間を表す {{domxref("DOMHighResTimeStamp")}}。
+
{{domxref("PerformanceEntry.duration")}} {{readonlyInline}}
+
パフォーマンスイベントの期間の時間値を表す {{domxref("DOMHighResTimeStamp")}}。
+
+ +

メソッド

+ +
+
{{domxref("PerformanceEntry.toJSON","PerformanceEntry.toJSON()")}}
+
PerformanceEntry オブジェクトの JSON リプリゼンテーションを返します。
+
+ +

例

+ +

次の例では、すべての PerformanceEntry プロパティを調べて、ブラウザがそれらをサポートしているかどうかを確認し、サポートしている場合はそれらの値をコンソールに書き込みます。

+ +
function print_PerformanceEntries() {
+  // getEntries() を使用してすべてのパフォーマンスエントリのリストを取得します。
+  var p = performance.getEntries();
+  for (var i=0; i < p.length; i++) {
+    console.log("PerformanceEntry[" + i + "]");
+    print_PerformanceEntry(p[i]);
+  }
+}
+function print_PerformanceEntry(perfEntry) {
+  var properties = ["name",
+                    "entryType",
+                    "startTime",
+                    "duration"];
+
+  for (var i=0; i < properties.length; i++) {
+    // それぞれのプロパティをチェックします。
+    var supported = properties[i] in perfEntry;
+    if (supported) {
+      var value = perfEntry[properties[i]];
+      console.log("... " + properties[i] + " = " + value);
+    } else {
+      console.log("... " + properties[i] + " is NOT supported");
+    }
+  }
+}
+
+ +

仕様

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
仕様書ステータスコメント
{{SpecName('Resource Timing 3')}}{{Spec2('Resource Timing 3')}} 
{{SpecName('Resource Timing 2')}}{{Spec2('Resource Timing 2')}} 
{{SpecName('Resource Timing')}}{{Spec2('Resource Timing')}}{{domxref("PerformanceResourceTiming")}} インターフェイスと entryType の resource 値を追加します。
{{SpecName('Navigation Timing Level 2')}}{{Spec2('Navigation Timing Level 2')}} 
{{SpecName('Navigation Timing')}}{{Spec2('Navigation Timing')}}{{domxref("PerformanceNavigationTiming")}} インターフェイスと entryType の navigation 値を追加します。
{{SpecName('User Timing Level 2')}}{{Spec2('User Timing Level 2')}} 
{{SpecName('User Timing')}}{{Spec2('User Timing')}}entryType の mark および measure の値と同様に、{{domxref("PerformanceMark")}} および {{domxref("PerformanceMeasure")}} インターフェイスを追加します。
{{SpecName('Frame Timing')}}{{Spec2('Frame Timing')}}{{domxref('PerformanceFrameTiming')}} インターフェイスと entryType の frame 値を追加します。
{{SpecName('Performance Timeline Level 2', '#dom-performanceentry', 'PerformanceEntry')}}{{Spec2('Performance Timeline Level 2')}}toJSON() シリアライザメソッドを追加しました。
{{SpecName('Performance Timeline', '#dom-performanceentry', 'PerformanceEntry')}}{{Spec2('Performance Timeline')}}初期定義
+ +

ブラウザの互換性

+ +
+ + +

{{Compat("api.PerformanceEntry")}}

+
diff --git a/files/ja/web/api/performanceentry/name/index.html b/files/ja/web/api/performanceentry/name/index.html new file mode 100644 index 0000000000..8fd701cbe1 --- /dev/null +++ b/files/ja/web/api/performanceentry/name/index.html @@ -0,0 +1,146 @@ +--- +title: PerformanceEntry.name +slug: Web/API/PerformanceEntry/name +tags: + - API + - Web パフォーマンス + - プロパティ + - リファレンス +translation_of: Web/API/PerformanceEntry/name +--- +
{{APIRef("Performance Timeline API")}}
+ +

{{domxref("PerformanceEntry")}} インターフェイスの name プロパティは、{{domxref("PerformanceEntry.entryType")}} プロパティによって返される値をさらに指定する値を返します。このプロパティは読み取り専用です。

+ +

{{AvailableInWorkers}}

+ +

構文

+ +
var name = entry.name;
+
+ +

戻り値

+ +

以下の表に示すように、戻り値は PerformanceEntry オブジェクトのサブタイプと {{domxref("PerformanceEntry.entryType")}} の値によって異なります。

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
値サブタイプentryType の値説明
{{domxref("URL")}}{{domxref('PerformanceFrameTiming')}}, {{domxref('PerformanceNavigationTiming')}}frame, navigationドキュメントのアドレス
{{domxref("URL")}}{{domxref('PerformanceResourceTiming')}}resourceリクエストされたリソースの解決されたURL。リクエストがリダイレクトされても、この値は変わりません。
{{domxref("DOMString")}}{{domxref('PerformanceMark')}}mark{{domxref("Performance.mark","performance.mark()")}} を呼び出してマークを作成したときに使用された名前。
{{domxref("DOMString")}}{{domxref('PerformanceMeasure')}}measureメジャーが {{domxref("Performance.measure","performance.measure()")}} を呼び出して作成されたときに使用された名前。
{{domxref("DOMString")}}{{domxref('PerformancePaintTiming')}}paint'first-paint' もしくは 'first-contentful-paint' のいずれか
+ +

例

+ +

次の例は、name プロパティの使い方を示しています。

+ +
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 < p.length; i++) {
+    log("Entry[" + i + "]");
+    check_PerformanceEntry(p[i]);
+  }
+}
+function check_PerformanceEntry(obj) {
+  var properties = ["name", "entryType", "startTime", "duration"];
+  var methods = ["toJSON"];
+
+  for (var i=0; i < 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 < 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");
+    }
+  }
+}
+
+ +

仕様

+ + + + + + + + + + + + + + + + + + + +
仕様書ステータスコメント
{{SpecName('Performance Timeline Level 2', '#dom-performanceentry-name', 'name')}}{{Spec2('Performance Timeline Level 2')}} 
{{SpecName('Performance Timeline', '#dom-performanceentry-name', 'name')}}{{Spec2('Performance Timeline')}}初期定義
+ +

ブラウザの互換性

+ +
+ + +

{{Compat("api.PerformanceEntry.name")}}

+
diff --git a/files/ja/web/api/performanceentry/starttime/index.html b/files/ja/web/api/performanceentry/starttime/index.html new file mode 100644 index 0000000000..37ada31f10 --- /dev/null +++ b/files/ja/web/api/performanceentry/starttime/index.html @@ -0,0 +1,116 @@ +--- +title: PerformanceEntry.startTime +slug: Web/API/PerformanceEntry/startTime +tags: + - API + - Web パフォーマンス + - プロパティ + - リファレンス +translation_of: Web/API/PerformanceEntry/startTime +--- +
{{APIRef("Performance Timeline API")}}
+ +

startTime プロパティは、{{domxref("PerformanceEntry","performance entry")}} のうち最初に記録された {{domxref("DOMHighResTimeStamp","timestamp")}} を返します。

+ +

{{AvailableInWorkers}}

+ +

このプロパティによって返される値は、パフォーマンスエントリの{{domxref("PerformanceEntry.entryType","タイプ")}}によって異なります。

+ + + +

このプロパティは {{readonlyInline}} です。

+ +

構文

+ +
entry.startTime;
+ +

戻り値

+ +

{{domxref("PerformanceEntry","パフォーマンスエントリ")}}が作成されたときの最初のタイムスタンプを表す {{domxref("DOMHighResTimeStamp")}}。

+ +

メモ: パフォーマンスエントリが "resource" の {{domxref("PerformanceEntry.entryType","entryType")}}  を持つ場合 (つまり、エントリが{{domxref("PerformanceResourceTiming")}} オブジェクトである場合)、このプロパティは{{domxref("PerformanceEntry.fetchStart")}} {{domxref("DOMHighResTimeStamp","タイムスタンプ")}}を返します。

+ +

例

+ +

次の例は、startTime プロパティの使用方法を示しています。

+ +
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 < p.length; i++) {
+    log("Entry[" + i + "]");
+    check_PerformanceEntry(p[i]);
+  }
+}
+function check_PerformanceEntry(obj) {
+  var properties = ["name", "entryType", "startTime", "duration"];
+  var methods = ["toJSON"];
+
+  for (var i=0; i < 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 < 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");
+    }
+  }
+}
+
+ +

仕様

+ + + + + + + + + + + + + + + + + + + +
仕様書ステータスコメント
{{SpecName('Performance Timeline Level 2', '#dom-performanceentry-starttime', 'startTime')}}{{Spec2('Performance Timeline Level 2')}} 
{{SpecName('Performance Timeline', '#dom-performanceentry-starttime', 'startTime')}}{{Spec2('Performance Timeline')}}初期定義
+ +

ブラウザの互換性

+ +
+ + +

{{Compat("api.PerformanceEntry.startTime")}}

+
diff --git a/files/ja/web/api/performanceentry/tojson/index.html b/files/ja/web/api/performanceentry/tojson/index.html new file mode 100644 index 0000000000..adcf14851c --- /dev/null +++ b/files/ja/web/api/performanceentry/tojson/index.html @@ -0,0 +1,108 @@ +--- +title: PerformanceEntry.toJSON() +slug: Web/API/PerformanceEntry/toJSON +tags: + - API + - Web パフォーマンス + - メソッド + - リファレンス +translation_of: Web/API/PerformanceEntry/toJSON +--- +
{{APIRef("Performance Timeline API")}}
+ +

toJSON() メソッドはシリアライザで、{{domxref("PerformanceEntry","パフォーマンスエントリ")}}オブジェクトの JSON 表現を返します。

+ +

{{AvailableInWorkers}}

+ +

構文

+ +
json = perfEntry.toJSON();
+
+ +

引数

+ +
+
なし
+
 
+
+ +

戻り値

+ +
+
json
+
{{domxref("PerformanceEntry")}} オブジェクトのシリアル化である JSON オブジェクト
+
+ +

例

+ +

次の例は、toJSON() メソッドの使用方法を示しています。

+ +
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 < p.length; i++) {
+    log("Entry[" + i + "]");
+    check_PerformanceEntry(p[i]);
+  }
+}
+function check_PerformanceEntry(obj) {
+  var properties = ["name", "entryType", "startTime", "duration"];
+  var methods = ["toJSON"];
+
+  for (var i=0; i < 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 < 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");
+    }
+  }
+}
+
+ +

仕様

+ + + + + + + + + + + + + + +
仕様書ステータスコメント
{{SpecName('Performance Timeline Level 2', '#dom-performanceentry-tojson', 'toJSON')}}{{Spec2('Performance Timeline Level 2')}}toJSON() メソッドの初期定義
+ +

ブラウザの互換性

+ +
+ + +

{{Compat("api.PerformanceEntry.toJSON")}}

+
-- cgit v1.2.3-54-g00ecf