Skip to content

Commit 5b63bd8

Browse files
author
reffy-bot
committed
Update of TR report from new reffy run
Using reffy commit 19.0.1.
1 parent f38ed75 commit 5b63bd8

15 files changed

+186
-98
lines changed

‎tr/algorithms/webdriver2.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4046,7 +4046,7 @@
40464046
"html": "<p>If <a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-name\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-name-3\">cookie name</a> or <a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-value\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-value-1\">cookie value</a> is <a href=\"https://www.w3.org/TR/webdriver2/#dfn-null\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-null-55\"><code>null</code></a>,\n <a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-domain\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-domain-1\">cookie domain</a> is not equal to <var>session</var>'s <a href=\"https://www.w3.org/TR/webdriver2/#dfn-current-browsing-context\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-current-browsing-context-78\">current\n browsing context</a>'s <a href=\"https://www.w3.org/TR/webdriver2/#dfn-active-document\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-active-document-26\">active document</a>'s <a href=\"https://www.w3.org/TR/webdriver2/#dfn-domains\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-domains-2\">domain</a>,\n <a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-secure-only\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-secure-only-1\">cookie secure only</a> or <a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-http-only\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-http-only-2\">cookie HTTP only</a> are not boolean types,\n or <a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-expiry-time\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-expiry-time-2\">cookie expiry time</a> is not an integer type, or it less than 0 or greater than\n the <a href=\"https://www.w3.org/TR/webdriver2/#dfn-maximum-safe-integer\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-maximum-safe-integer-2\">maximum safe integer</a>, return <a href=\"https://www.w3.org/TR/webdriver2/#dfn-error\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-error-185\">error</a> with <a href=\"https://www.w3.org/TR/webdriver2/#dfn-error-code\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-error-code-172\">error\n code</a> <a href=\"https://www.w3.org/TR/webdriver2/#dfn-invalid-argument\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-invalid-argument-53\">invalid argument</a>.\n\n </p>"
40474047
},
40484048
{
4049-
"html": "<p><a href=\"https://www.w3.org/TR/webdriver2/#dfn-creating-a-cookie\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-creating-a-cookie-2\">Create a cookie</a> in\n the <a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-store\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-store-3\">cookie store</a> associated with\n the <a href=\"https://www.w3.org/TR/webdriver2/#dfn-active-document\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-active-document-27\">active document</a>'s <a data-link-type=\"element\" href=\"https://html.spec.whatwg.org/multipage/sections.html#the-address-element\" id=\"ref-for-index-term-address-element-2\">address</a>\n using <a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-name\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-name-4\">cookie name</a> <var>name</var>,\n <a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-value\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-value-2\">cookie value</a> <var>value</var>,\n and an attribute-value list of the following cookie concepts\n listed in the <a href=\"https://www.w3.org/TR/webdriver2/#dfn-table-for-cookie-conversion\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-table-for-cookie-conversion-3\">table for cookie conversion</a>\n from <var>data</var>:\n\n </p><dl>\n <dt><a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-path\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-path-1\">Cookie path</a>\n </dt><dd><p>The value if the entry exists, otherwise \"<code>/</code>\".\n\n </p></dd><dt><a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-domain\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-domain-2\">Cookie domain</a>\n </dt><dd><p>The value if the entry exists,\n otherwise <var>session</var>'s <a href=\"https://www.w3.org/TR/webdriver2/#dfn-current-browsing-context\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-current-browsing-context-79\">current browsing context</a>'s\n <a href=\"https://www.w3.org/TR/webdriver2/#dfn-active-document\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-active-document-28\">active document</a>'s <a href=\"https://www.w3.org/TR/webdriver2/#dfn-url\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-url-9\">URL</a> <a href=\"https://www.w3.org/TR/webdriver2/#dfn-domains\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-domains-3\">domain</a>.\n\n </p></dd><dt><a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-secure-only\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-secure-only-2\">Cookie secure only</a>\n </dt><dd><p>The value if the entry exists, otherwise false.\n\n </p></dd><dt><a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-http-only\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-http-only-3\">Cookie HTTP only</a>\n </dt><dd><p>The value if the entry exists, otherwise false.\n\n </p></dd><dt><a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-expiry-time\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-expiry-time-3\">Cookie expiry time</a>\n </dt><dd><p>The value if the entry exists, otherwise leave unset to\n indicate that this is a session cookie.\n\n </p></dd><dt><a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-same-site\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-same-site-1\">Cookie same site</a>\n </dt><dd><p>The value if the entry exists, otherwise leave unset to\n indicate that no same site policy is defined.\n </p></dd></dl>\n\n <p>If there is an <a href=\"https://www.w3.org/TR/webdriver2/#dfn-error\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-error-186\">error</a> during this step,\n return <a href=\"https://www.w3.org/TR/webdriver2/#dfn-error\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-error-187\">error</a> with <a href=\"https://www.w3.org/TR/webdriver2/#dfn-error-code\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-error-code-173\">error code</a> <a href=\"https://www.w3.org/TR/webdriver2/#dfn-unable-to-set-cookie\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-unable-to-set-cookie-1\">unable to set cookie</a>.\n\n\n </p>"
4049+
"html": "<p><a href=\"https://www.w3.org/TR/webdriver2/#dfn-creating-a-cookie\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-creating-a-cookie-2\">Create a cookie</a> in\n the <a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-store\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-store-3\">cookie store</a> associated with\n the <a href=\"https://www.w3.org/TR/webdriver2/#dfn-active-document\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-active-document-27\">active document</a>'s <a data-link-type=\"element\" href=\"https://html.spec.whatwg.org/multipage/sections.html#the-address-element\" id=\"ref-for-index-term-address-element-2\">address</a>\n using <a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-name\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-name-4\">cookie name</a> <var>name</var>,\n <a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-value\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-value-2\">cookie value</a> <var>value</var>,\n and an attribute-value list of the following cookie concepts\n listed in the <a href=\"https://www.w3.org/TR/webdriver2/#dfn-table-for-cookie-conversion\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-table-for-cookie-conversion-3\">table for cookie conversion</a>\n from <var>data</var>:\n\n </p><dl>\n <dt><a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-path\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-path-1\">Cookie path</a>\n </dt><dd><p>The value if the entry exists, otherwise \"<code>/</code>\".\n\n </p></dd><dt><a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-domain\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-domain-2\">Cookie domain</a>\n </dt><dd><p>The value if the entry exists,\n otherwise <var>session</var>'s <a href=\"https://www.w3.org/TR/webdriver2/#dfn-current-browsing-context\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-current-browsing-context-79\">current browsing context</a>'s\n <a href=\"https://www.w3.org/TR/webdriver2/#dfn-active-document\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-active-document-28\">active document</a>'s <a href=\"https://www.w3.org/TR/webdriver2/#dfn-url\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-url-9\">URL</a> <a href=\"https://www.w3.org/TR/webdriver2/#dfn-domains\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-domains-3\">domain</a>.\n\n </p></dd><dt><a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-secure-only\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-secure-only-2\">Cookie secure only</a>\n </dt><dd><p>The value if the entry exists, otherwise false.\n\n </p></dd><dt><a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-http-only\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-http-only-3\">Cookie HTTP only</a>\n </dt><dd><p>The value if the entry exists, otherwise false.\n\n </p></dd><dt><a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-expiry-time\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-expiry-time-3\">Cookie expiry time</a>\n </dt><dd><p>The value if the entry exists, otherwise leave unset to\n indicate that this is a session cookie.\n\n </p>\n\n </dd><dt><a href=\"https://www.w3.org/TR/webdriver2/#dfn-cookie-same-site\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-cookie-same-site-1\">Cookie same site</a>\n </dt><dd><p>The value if the entry exists, otherwise leave unset to\n indicate that no same site policy is defined.\n </p></dd></dl>\n\n <p>If there is an <a href=\"https://www.w3.org/TR/webdriver2/#dfn-error\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-error-186\">error</a> during this step,\n return <a href=\"https://www.w3.org/TR/webdriver2/#dfn-error\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-error-187\">error</a> with <a href=\"https://www.w3.org/TR/webdriver2/#dfn-error-code\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-error-code-173\">error code</a> <a href=\"https://www.w3.org/TR/webdriver2/#dfn-unable-to-set-cookie\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-unable-to-set-cookie-1\">unable to set cookie</a>.\n\n </p>"
40504050
},
40514051
{
40524052
"html": "<p>Return <a href=\"https://www.w3.org/TR/webdriver2/#dfn-success\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-success-93\">success</a> with data <a href=\"https://www.w3.org/TR/webdriver2/#dfn-null\" class=\"internalDFN\" data-link-type=\"dfn\" id=\"ref-for-dfn-null-56\"><code>null</code></a>.\n</p>"

‎tr/dfns/design-principles.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919
"id": "live-vs-static",
2020
"href": "https://www.w3.org/TR/design-principles/#live-vs-static",
2121
"title": "Consider whether objects should be live or static",
22-
"number": "6.2"
22+
"number": "6.3"
2323
},
2424
"definedIn": "prose"
2525
},
@@ -38,7 +38,7 @@
3838
"id": "live-vs-static",
3939
"href": "https://www.w3.org/TR/design-principles/#live-vs-static",
4040
"title": "Consider whether objects should be live or static",
41-
"number": "6.2"
41+
"number": "6.3"
4242
},
4343
"definedIn": "prose"
4444
},

‎tr/headings/design-principles.json

Lines changed: 53 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -350,22 +350,59 @@
350350
"id": "api-surface",
351351
"href": "https://www.w3.org/TR/design-principles/#api-surface",
352352
"level": 2,
353-
"title": "JavaScript API Surface Concerns",
353+
"title": "Designing JavaScript APIs",
354354
"number": "6"
355355
},
356+
{
357+
"id": "webidl-dictionaries-interfaces-namespaces",
358+
"href": "https://www.w3.org/TR/design-principles/#webidl-dictionaries-interfaces-namespaces",
359+
"level": 3,
360+
"title": "Use WebIDL dictionaries, interfaces, and namespaces appropriately",
361+
"number": "6.1"
362+
},
363+
{
364+
"id": "dictionaries-for-configuration",
365+
"href": "https://www.w3.org/TR/design-principles/#dictionaries-for-configuration",
366+
"level": 4,
367+
"title": "Use Dictionaries for “Configuration” or “Input-Only” Data"
368+
},
369+
{
370+
"id": "interface-for-functionality-state-identity",
371+
"href": "https://www.w3.org/TR/design-principles/#interface-for-functionality-state-identity",
372+
"level": 4,
373+
"title": "Choose an Interface for Functionality, State, and Identity"
374+
},
375+
{
376+
"id": "interface-serializer",
377+
"href": "https://www.w3.org/TR/design-principles/#interface-serializer",
378+
"level": 4,
379+
"title": "Provide a serializer to make interface data more accessible"
380+
},
381+
{
382+
"id": "namespace-to-avoid-fake-classes",
383+
"href": "https://www.w3.org/TR/design-principles/#namespace-to-avoid-fake-classes",
384+
"level": 4,
385+
"title": "Choose a namespace to Avoid “Fake Classes” for Behavior-Only Utilities"
386+
},
387+
{
388+
"id": "pseudo-namespaces",
389+
"href": "https://www.w3.org/TR/design-principles/#pseudo-namespaces",
390+
"level": 4,
391+
"title": "\"Pseudo-namespaces\""
392+
},
356393
{
357394
"id": "attributes-like-data",
358395
"href": "https://www.w3.org/TR/design-principles/#attributes-like-data",
359396
"level": 3,
360397
"title": "Attributes should behave like data properties",
361-
"number": "6.1"
398+
"number": "6.2"
362399
},
363400
{
364401
"id": "live-vs-static",
365402
"href": "https://www.w3.org/TR/design-principles/#live-vs-static",
366403
"level": 3,
367404
"title": "Consider whether objects should be live or static",
368-
"number": "6.2"
405+
"number": "6.3"
369406
},
370407
{
371408
"id": "live-objects",
@@ -384,56 +421,56 @@
384421
"href": "https://www.w3.org/TR/design-principles/#attributes-vs-methods",
385422
"level": 3,
386423
"title": "Accessors should behave like properties, not methods",
387-
"number": "6.3"
424+
"number": "6.4"
388425
},
389426
{
390427
"id": "prefer-dictionaries",
391428
"href": "https://www.w3.org/TR/design-principles/#prefer-dictionaries",
392429
"level": 3,
393430
"title": "Accept optional and/or primitive arguments through dictionaries",
394-
"number": "6.4"
431+
"number": "6.5"
395432
},
396433
{
397434
"id": "optional-parameters",
398435
"href": "https://www.w3.org/TR/design-principles/#optional-parameters",
399436
"level": 3,
400437
"title": "Make method arguments optional if possible",
401-
"number": "6.5"
438+
"number": "6.6"
402439
},
403440
{
404441
"id": "naming-optional-parameters",
405442
"href": "https://www.w3.org/TR/design-principles/#naming-optional-parameters",
406443
"level": 3,
407444
"title": "Name optional arguments appropriately",
408-
"number": "6.6"
445+
"number": "6.7"
409446
},
410447
{
411448
"id": "overloading",
412449
"href": "https://www.w3.org/TR/design-principles/#overloading",
413450
"level": 3,
414451
"title": "Use overloading wisely",
415-
"number": "6.7"
452+
"number": "6.8"
416453
},
417454
{
418455
"id": "constructors",
419456
"href": "https://www.w3.org/TR/design-principles/#constructors",
420457
"level": 3,
421458
"title": "Classes should have constructors when possible",
422-
"number": "6.8"
459+
"number": "6.9"
423460
},
424461
{
425462
"id": "synchronous",
426463
"href": "https://www.w3.org/TR/design-principles/#synchronous",
427464
"level": 3,
428465
"title": "Be synchronous when appropriate",
429-
"number": "6.9"
466+
"number": "6.10"
430467
},
431468
{
432469
"id": "promises",
433470
"href": "https://www.w3.org/TR/design-principles/#promises",
434471
"level": 3,
435472
"title": "Design asynchronous APIs using Promises",
436-
"number": "6.10"
473+
"number": "6.11"
437474
},
438475
{
439476
"id": "sync-callbacks",
@@ -446,35 +483,35 @@
446483
"href": "https://www.w3.org/TR/design-principles/#aborting",
447484
"level": 3,
448485
"title": "Cancel asynchronous APIs/operations using AbortSignal",
449-
"number": "6.11"
486+
"number": "6.12"
450487
},
451488
{
452489
"id": "string-constants",
453490
"href": "https://www.w3.org/TR/design-principles/#string-constants",
454491
"level": 3,
455492
"title": "Use strings for constants and enums",
456-
"number": "6.12"
493+
"number": "6.13"
457494
},
458495
{
459496
"id": "async-by-default",
460497
"href": "https://www.w3.org/TR/design-principles/#async-by-default",
461498
"level": 3,
462499
"title": "If you need both asynchronous and synchronous methods, synchronous is the exception",
463-
"number": "6.13"
500+
"number": "6.14"
464501
},
465502
{
466503
"id": "uint8array",
467504
"href": "https://www.w3.org/TR/design-principles/#uint8array",
468505
"level": 3,
469506
"title": "Output an array of bytes with Uint8Array",
470-
"number": "6.14"
507+
"number": "6.15"
471508
},
472509
{
473510
"id": "void-functions",
474511
"href": "https://www.w3.org/TR/design-principles/#void-functions",
475512
"level": 3,
476513
"title": "Return undefined from side-effect-causing functions",
477-
"number": "6.15"
514+
"number": "6.16"
478515
},
479516
{
480517
"id": "event-design",

‎tr/ids/design-principles.json

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -246,6 +246,12 @@
246246
"https://www.w3.org/TR/design-principles/#ref-for-sec-weak-ref-objects",
247247
"https://www.w3.org/TR/design-principles/#ref-for-sec-finalization-registry-objects",
248248
"https://www.w3.org/TR/design-principles/#api-surface",
249+
"https://www.w3.org/TR/design-principles/#webidl-dictionaries-interfaces-namespaces",
250+
"https://www.w3.org/TR/design-principles/#dictionaries-for-configuration",
251+
"https://www.w3.org/TR/design-principles/#interface-for-functionality-state-identity",
252+
"https://www.w3.org/TR/design-principles/#interface-serializer",
253+
"https://www.w3.org/TR/design-principles/#namespace-to-avoid-fake-classes",
254+
"https://www.w3.org/TR/design-principles/#pseudo-namespaces",
249255
"https://www.w3.org/TR/design-principles/#attributes-like-data",
250256
"https://www.w3.org/TR/design-principles/#example-92914693",
251257
"https://www.w3.org/TR/design-principles/#ref-for-dom-htmlelement-offsettop",
@@ -913,6 +919,7 @@
913919
"https://www.w3.org/TR/design-principles/#biblio-uievents",
914920
"https://www.w3.org/TR/design-principles/#biblio-unsanctioned-tracking",
915921
"https://www.w3.org/TR/design-principles/#biblio-web-locks",
922+
"https://www.w3.org/TR/design-principles/#biblio-web-share",
916923
"https://www.w3.org/TR/design-principles/#biblio-webaudio",
917924
"https://www.w3.org/TR/design-principles/#biblio-webcrypto-2",
918925
"https://www.w3.org/TR/design-principles/#biblio-webrtc",

0 commit comments

Comments
 (0)