aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/performanceresourcetiming/transfersize/index.html
blob: 3cedbf76d00512f03cf45b8227fc04032694328c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
---
title: PerformanceResourceTiming.transferSize
slug: Web/API/PerformanceResourceTiming/transferSize
tags:
  - API
  - Web パフォーマンス
  - プロパティ
  - リファレンス
translation_of: Web/API/PerformanceResourceTiming/transferSize
---
<div>{{APIRef("Resource Timing API")}}</div>

<p><strong><code>transferSize</code></strong> 読み取り専用プロパティは、取得したリソースのサイズ (オクテット) を表します。サイズには、レスポンスヘッダーフィールドとレスポンスペイロードボディ (<a href="http://httpwg.github.io/specs/rfc7230.html#message.body">RFC7230</a> で定義されているとおり) が含まれます。</p>

<p>{{AvailableInWorkers}}</p>

<p>リソースがローカルキャッシュから取得された場合、またはクロスオリジンリソースの場合、このプロパティはゼロを返します。</p>

<h2 id="Syntax" name="Syntax">構文</h2>

<pre class="syntaxbox"><em>resource</em>.transferSize;
</pre>

<h3 id="Return_Value" name="Return_Value">戻り値</h3>

<p>取得したリソースのサイズ (オクテット単位) を表す数値。サイズには、レスポンスヘッダーフィールドと<a href="http://httpwg.github.io/specs/rfc7230.html#message.body">レスポンスペイロードボディ</a> (RFC7230) が含まれています。</p>

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

<p>次の例では、すべての "<code>resource</code>" {{domxref("PerformanceEntry.entryType","type")}} イベントのサイズプロパティの値が記録されます。</p>

<pre class="brush: js">function log_sizes(perfEntry){
  // Check for support of the PerformanceEntry.*size properties and print their values
  // if supported.
  if ("decodedBodySize" in perfEntry)
    console.log("decodedBodySize = " + perfEntry.decodedBodySize);
  else
    console.log("decodedBodySize = NOT supported");

  if ("encodedBodySize" in perfEntry)
    console.log("encodedBodySize = " + perfEntry.encodedBodySize);
  else
    console.log("encodedBodySize = NOT supported");

  if ("transferSize" in perfEntry)
    console.log("transferSize = " + perfEntry.transferSize);
  else
    console.log("transferSize = NOT supported");
}
function check_PerformanceEntries() {
  // Use getEntriesByType() to just get the "resource" events
  var p = performance.getEntriesByType("resource");
  for (var i=0; i &lt; p.length; i++) {
    log_sizes(p[i]);
  }
}
</pre>

<h2 id="仕様">仕様</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">仕様書</th>
   <th scope="col">ステータス</th>
   <th scope="col">コメント</th>
  </tr>
  <tr>
   <td>{{SpecName('Resource Timing', '#widl-PerformanceResourceTiming-transferSize', 'transferSize')}}</td>
   <td>{{Spec2('Resource Timing')}}</td>
   <td>初期定義</td>
  </tr>
 </tbody>
</table>

<h2 id="ブラウザの互換性">ブラウザの互換性</h2>

<div>
<p>{{Compat("api.PerformanceResourceTiming.transferSize")}}</p>
</div>