|
120 | 120 | ●●options |
121 | 121 |
|
122 | 122 | spec_title:Reporting API |
123 | | -spec_date:2025-09-05 |
124 | | -trans_update:2025-09-25 |
125 | | -source_checked:201019 |
| 123 | +spec_date:2026-01-02 |
| 124 | +trans_update:2026-02-25 |
| 125 | +source_checked:260102 |
126 | 126 | page_state_key:WEBAPPSEC |
127 | 127 | original_url:https://w3c.github.io/reporting/ |
128 | 128 | abbr_url:REPORTING |
129 | 129 | spec_status:ED |
130 | 130 | ref_id_prefix:biblio- |
131 | 131 | ref_id_lowercase:true |
132 | | -copyright:2025,permissive |
| 132 | +copyright:2026,permissive |
133 | 133 | trans_1st_pub:2016-06-06 |
134 | 134 |
|
135 | 135 |
|
|
686 | 686 | [INFRA] |
687 | 687 | Anne van Kesteren; Domenic Denicola. <Infra Standard>. Living Standard. URL: https://infra.spec.whatwg.org/ |
688 | 688 | [RDF12-CONCEPTS] |
689 | | - Olaf Hartig; et al. <RDF 1.2 Concepts and Abstract Data Model>. URL: https://w3c.github.io/rdf-concepts/spec/ |
| 689 | + Gregg Kellogg; et al. <RDF 1.2 Concepts and Abstract Data Model>. URL: https://w3c.github.io/rdf-concepts/spec/ |
690 | 690 | [RFC3864] |
691 | 691 | G. Klyne; M. Nottingham; J. Mogul. <Registration Procedures for Message Header Fields>. September 2004. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc3864 |
692 | 692 | [RFC5234] |
@@ -765,30 +765,19 @@ <h1>Reporting API</h1> |
765 | 765 | <section id="abstract"> |
766 | 766 | ◎要約 |
767 | 767 |
|
768 | | -<div class="p"> |
769 | 768 | <p> |
770 | 769 | この文書は、 |
771 | | -報告処理の汎用~frameworkを定義する: |
772 | | -</p> |
773 | | - |
774 | | -<ol> |
775 | | - <li> |
776 | | -開発者は、 |
| 770 | +報告処理の汎用な~frameworkを定義する |
| 771 | +— それは、 |
777 | 772 | 名前が付与された[ |
778 | | -`報告先$の集合 |
779 | | -]を,`生成元$に結付けれる。 |
780 | | -</li> |
781 | | - <li> |
782 | | -様々な~platform特能 |
783 | | -( `CSP3$r, `NETWORK-ERROR-LOGGING$r【!Network Error Reporting】, その他) |
784 | | -が、 |
785 | | -これらの報告先を利用して,それぞれに特有な報告を一貫した方式で送達する。 |
786 | | -</li> |
787 | | -</ol> |
788 | | - |
| 773 | +`報告先$たちが成す集合 |
| 774 | +]を`生成元$に結付ることを開発者に許容する。 |
| 775 | +様々な~platform特能が, |
| 776 | +これらの報告先を利用して、 |
| 777 | +各自に特有な報告を一貫した方式で送達できる。 |
789 | 778 | ◎ |
790 | | -This document defines a generic reporting framework which allows web developers to associate a set of named reporting endpoints with an origin. Various platform features (like Content Security Policy, Network Error Reporting, and others) will use these endpoints to deliver feature-specific reports in a consistent manner. |
791 | | -</div> |
| 779 | +This document defines a generic reporting framework which allows web developers to associate a set of named reporting endpoints with an origin. Various platform features can use these endpoints to deliver feature-specific reports in a consistent manner. |
| 780 | +</p> |
792 | 781 |
|
793 | 782 | </section> |
794 | 783 | <section id="sotd"> |
@@ -993,7 +982,7 @@ <h4 title="Endpoints">2.1.1. 報告先</h4> |
993 | 982 |
|
994 | 983 | <p> |
995 | 984 | 各 `報告先$は、 |
996 | | -次のものを持つ: |
| 985 | +次に挙げるものを有する: |
997 | 986 | ◎ |
998 | 987 | ↓</p> |
999 | 988 |
|
@@ -1075,7 +1064,7 @@ <h4 title="Reports">2.1.3. 報告</h4> |
1075 | 1064 |
|
1076 | 1065 | <p> |
1077 | 1066 | 各 `報告$は、 |
1078 | | -次に挙げるものを持つ: |
| 1067 | +次に挙げるものを有する: |
1079 | 1068 | ◎ |
1080 | 1069 | ↓</p> |
1081 | 1070 |
|
@@ -1222,12 +1211,11 @@ <h3 title="Queue data as type for destination">2.3. ある種別の報告を %~d |
1222 | 1211 | 直列化-可能な~obj %~data, |
1223 | 1212 | 文字列 %種別, |
1224 | 1213 | 文字列 %行先, |
1225 | | -`環境~設定群~obj$ %設定群 ~DF ε, |
1226 | | -`~URL$ %~URL ~DF ε |
| 1214 | +`環境~設定群~obj$ %設定群 ~DF ε |
1227 | 1215 | ◎終 |
1228 | 1216 | に対し: |
1229 | 1217 | ◎ |
1230 | | -To generate a report given a serializable object (data), a string (type), another string (destination), an optional environment settings object (settings), and an optional URL (url): |
| 1218 | +To generate a report given a serializable object (data), a string (type), another string (destination), and an environment settings object (settings): |
1231 | 1219 | </p> |
1232 | 1220 |
|
1233 | 1221 | <ol> |
@@ -1258,13 +1246,9 @@ <h3 title="Queue data as type for destination">2.3. ある種別の報告を %~d |
1258 | 1246 | • 0 |
1259 | 1247 | </li> |
1260 | 1248 | <li> |
1261 | | -~IF[ |
1262 | | -%~URL ~EQ ε |
1263 | | -] |
1264 | | -⇒ |
1265 | | -%~URL ~SET %設定群 の`作成時の~URL$ |
| 1249 | +%~URL ~LET %設定群 の`作成時の~URL$ |
1266 | 1250 | ◎ |
1267 | | -If url was not provided by the caller, let url be settings’s creation URL. |
| 1251 | +Let url be settings’s creation URL. |
1268 | 1252 | </li> |
1269 | 1253 | <li> |
1270 | 1254 | %~URL の |
@@ -1408,7 +1392,7 @@ <h3 title="Serialize Reports">2.4. 報告を直列化する</h3> |
1408 | 1392 | <li> |
1409 | 1393 | ~RET `~Infra値を~JSON~byte列に直列化する$( %~collection ) |
1410 | 1394 | ◎ |
1411 | | -Return the byte sequence resulting from executing serialize JSON to bytes on collection. |
| 1395 | +Return the byte sequence resulting from executing serialize an Infra value to JSON bytes on collection. |
1412 | 1396 | </li> |
1413 | 1397 | </ol> |
1414 | 1398 | </div> |
@@ -2067,7 +2051,7 @@ <h4 title="Attempt to deliver reports to endpoint">3.5.2. %報告先 へ %報告 |
2067 | 2051 | origin |
2068 | 2052 | • origin |
2069 | 2053 | header list |
2070 | | -• A new header list containing a header named `Content-Type` whose value is "application/reports+json" |
| 2054 | +• A new header list containing a header named `Content-Type` whose value is `application/reports+json` |
2071 | 2055 | client |
2072 | 2056 | • null |
2073 | 2057 | window |
@@ -2339,34 +2323,34 @@ <h3 title="Interface ReportingObserver">4.1. ~interface `ReportingObserver^I</h3 |
2339 | 2323 |
|
2340 | 2324 | <p> |
2341 | 2325 | 各 `ReportingObserver$I ~objには、 |
2342 | | -次の概念が結付けられる: |
| 2326 | +次に挙げる概念が結付けられる: |
2343 | 2327 | ◎ |
2344 | 2328 | Each ReportingObserver object has these associated concepts: |
2345 | 2329 | </p> |
2346 | | - |
2347 | | -<dl class="def-list"> |
2348 | | - <dt>`~callback@ob</dt> |
2349 | | - <dd> |
| 2330 | +<ul> |
| 2331 | + <li> |
| 2332 | +`~callback@ob |
| 2333 | +⇒ |
2350 | 2334 | 作成-時に設定される~callback関数。 |
2351 | 2335 | ◎ |
2352 | 2336 | A callback function set on creation. |
2353 | | -</dd> |
2354 | | - |
2355 | | - <dt>`~option群@ob</dt> |
2356 | | - <dd> |
| 2337 | +</li> |
| 2338 | + <li> |
| 2339 | +`~option群@ob |
| 2340 | +⇒ |
2357 | 2341 | 作成-時に設定される `ReportingObserverOptions$I 辞書。 |
2358 | 2342 | ◎ |
2359 | 2343 | A ReportingObserverOptions dictionary called options. |
2360 | | -</dd> |
2361 | | - |
2362 | | - <dt>`報告~queue@ob</dt> |
2363 | | - <dd> |
| 2344 | +</li> |
| 2345 | + <li> |
| 2346 | +`報告~queue@ob |
| 2347 | +⇒ |
2364 | 2348 | `Report$I ~objたちが成す~list。 |
2365 | 2349 | 初期~時には空とする。 |
2366 | 2350 | ◎ |
2367 | 2351 | A list of Report objects called the report queue, which is initially empty. |
2368 | | -</dd> |
2369 | | -</dl> |
| 2352 | +</li> |
| 2353 | +</ul> |
2370 | 2354 |
|
2371 | 2355 | <p> |
2372 | 2356 | `ReportList$I は、 |
@@ -2585,15 +2569,15 @@ <h3 title="Add report to observer">4.3. 観測器に報告を追加する</h3> |
2585 | 2569 | %報告~obj ~LET 新たな `Report$I ~obj |
2586 | 2570 | — その |
2587 | 2571 | ⇒# |
2588 | | -`type$m ~SET %報告 の`種別$rP, |
2589 | | -`url$m ~SET %報告 の`~URL$rP, |
2590 | | -`body$m ~SET %報告 の`本体$rP |
| 2572 | +`type$mb ~SET %報告 の`種別$rP, |
| 2573 | +`url$mb ~SET %報告 の`~URL$rP, |
| 2574 | +`body$mb ~SET %報告 の`本体$rP |
2591 | 2575 | ◎ |
2592 | 2576 | Create a new Report r with type initialized to report’s type, url initialized to report’s url, and body initialized to report’s body. |
2593 | 2577 | </p> |
2594 | 2578 |
|
2595 | 2579 | <p class="issue"> |
2596 | | -`body$m を多形態的に初期化するにはどうする? |
| 2580 | +`body$mb を多形態的に初期化するにはどうする? |
2597 | 2581 | ◎ |
2598 | 2582 | how to polymorphically initialize body? |
2599 | 2583 | </p> |
@@ -3118,7 +3102,7 @@ <h3 title="Cross-origin correlation">9.3. 非同一-生成元の相関</h3> |
3118 | 3102 | その報告先は,[ |
3119 | 3103 | それぞれから生成元~付きの報告を受信する |
3120 | 3104 | ]ことになるので、 |
3121 | | -特定0の利用者がある~websiteの集合とやりとりしたことを学習できることになる。 |
| 3105 | +特定0の利用者がある~websiteたちが成す集合とやりとりしたことを学習できることになる。 |
3122 | 3106 | これは、[ |
3123 | 3107 | 複数の生成元が,同じ情報を協力的に追跡する能 |
3124 | 3108 | ]がある現状を,より悪化させるものには見えない。 |
|
0 commit comments