Update user prompt handler note for fallbackDefault (#1831)

juliandescottes · github-actions[bot] · juliandescottes · commit d1026c7204b8 · 2024-07-23T11:03:38.000Z
SHA: 7a23ea0 Reason: push, by jgraham Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
diff --git a/index.html b/index.html
@@ -176,7 +176,7 @@
 .mdn .samsunginternet_android::before{background-image:url(https://www.w3.org/assets/logos/browser-logos/samsung-internet/samsung-internet.svg)}
 .mdn .webview_android::before{background-image:url(https://www.w3.org/assets/logos/browser-logos/android-webview/android-webview.png)}
 </style>
-<meta name="revision" content="57eb5e9b7cbb2593118900b575e1d194b896dd7c">
+<meta name="revision" content="7a23ea0cc2579b65a6994f2919a5b0adf990fe8b">
 <meta name="description" content="WebDriver is a remote control interface
 that enables introspection and control of user agents.
 It provides a platform- and language-neutral wire protocol
@@ -272,15 +272,15 @@
     ],
     "profile": "web-platform"
   },
-  "gitRevision": "57eb5e9b7cbb2593118900b575e1d194b896dd7c",
-  "publishISODate": "2024-07-17T00:00:00.000Z",
-  "generatedSubtitle": "W3C Editor's Draft 17 July 2024"
+  "gitRevision": "7a23ea0cc2579b65a6994f2919a5b0adf990fe8b",
+  "publishISODate": "2024-07-23T00:00:00.000Z",
+  "generatedSubtitle": "W3C Editor's Draft 23 July 2024"
 }</script>
 <link rel="stylesheet" href="https://www.w3.org/StyleSheets/TR/2021/W3C-ED"></head><body data-cite="WEBIDL CSSOM-VIEW GEOMETRY-1 fileapi HTML INFRA URL WEBIDL DOM FETCH" class="h-entry"><div class="head">
     <p class="logos"><a class="logo" href="https://www.w3.org/"><img crossorigin="" alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2021/logos/W3C" width="72">
   </a></p>
     <h1 id="title" class="title">WebDriver</h1> 
-    <p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">W3C Editor's Draft</a> <time class="dt-published" datetime="2024-07-17">17 July 2024</time></p>
+    <p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">W3C Editor's Draft</a> <time class="dt-published" datetime="2024-07-23">23 July 2024</time></p>
     <details open="">
       <summary>More details about this document</summary>
       <dl>
@@ -11234,13 +11234,18 @@ <h1 id="title" class="title">WebDriver</h1>
 "<code>default</code>", "<code>prompt</code>"».
 
 </p><div class="note" role="note" id="issue-container-generatedID-57"><div role="heading" class="note-title marker" id="h-note-57" aria-level="3"><span>Note</span></div><p class="">The "<code>default</code>" type represents a fallback
-when no specific handler is defined for a given prompt type. The
-"<code>beforeUnload</code>" prompt type does not use this default
-handler, but instead falls back to the "<code>accept</code>" handler
-if no more specific handler is defined. This is because HTTP-only
-sessions do not allow the "<code>beforeUnload</code>" handler to be
-customized, and enabling other protocols isn't expected to change
-the user prompt handling as a side effect.
+when no specific handler is defined for a given prompt type, including
+the "<code>beforeUnload</code>" prompt type. It can only be set if the
+unhandled prompt behavior is a <a data-type="dfn" href="https://infra.spec.whatwg.org/#ordered-map" id="ref-for-index-term-map-5">map</a> which
+<a data-link-type="dfn|abstract-op" data-type="dfn" href="https://infra.spec.whatwg.org/#map-exists" id="ref-for-index-term-contains-for-map-5">contains</a> "<code>default</code>". For HTTP-only sessions setting
+unhandled prompt behavior as a string value, the value will be assigned to
+the internal type "<code>fallbackDefault</code>". The
+"<code>fallbackDefault</code>" value is not used for the
+"<code>beforeUnload</code>" prompt type, instead it falls back to the
+"<code>accept</code>" handler. This is because HTTP-only sessions do not
+allow the "<code>beforeUnload</code>" handler to be customized, and enabling
+other protocols isn't expected to change the user prompt handling as a
+side effect.
 
 </p></div><p>To <dfn id="dfn-deserialize-as-an-unhandled-prompt-behavior" tabindex="0" aria-haspopup="dialog" data-dfn-type="dfn">deserialize as an unhandled prompt behavior</dfn> given
 argument <var>value</var>:
@@ -11262,19 +11267,19 @@ <h1 id="title" class="title">WebDriver</h1>
  </p></div></li><li><p>Let <var>is string value</var> be false.
 
  </p></li><li><p>If <var>value</var> is a <a href="#dfn-string" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-string-14">string</a> set <var>value</var> to
- the <a data-type="dfn" href="https://infra.spec.whatwg.org/#ordered-map" id="ref-for-index-term-map-5">map</a> «["<code>fallbackDefault</code>"
+ the <a data-type="dfn" href="https://infra.spec.whatwg.org/#ordered-map" id="ref-for-index-term-map-6">map</a> «["<code>fallbackDefault</code>"
  → <var>value</var>]» and set <var>is string value</var> to true.
 
- </p></li><li><p>If <var>value</var> is not a <a data-type="dfn" href="https://infra.spec.whatwg.org/#ordered-map" id="ref-for-index-term-map-6">map</a> return
+ </p></li><li><p>If <var>value</var> is not a <a data-type="dfn" href="https://infra.spec.whatwg.org/#ordered-map" id="ref-for-index-term-map-7">map</a> return
  <a href="#dfn-error" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-error-251">error</a> with <a href="#dfn-error-code" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-error-code-225">error code</a> <a href="#dfn-invalid-argument" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-invalid-argument-100">invalid argument</a>.
 
- </p></li><li>Let <var>user prompt handler</var> be an empty <a data-type="dfn" href="https://infra.spec.whatwg.org/#ordered-map" id="ref-for-index-term-map-7">map</a>.
+ </p></li><li>Let <var>user prompt handler</var> be an empty <a data-type="dfn" href="https://infra.spec.whatwg.org/#ordered-map" id="ref-for-index-term-map-8">map</a>.
 
  </li><li><p>For each <var>prompt type</var> → <var>handler</var> in <var>value</var>:
 
   </p><ol>
    <li><p>If <var>is string value</var> is false and <a href="#dfn-valid-prompt-types" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-valid-prompt-types-1">valid prompt
-   types</a> does not <a data-link-type="dfn|abstract-op" data-type="dfn" href="https://infra.spec.whatwg.org/#map-exists" id="ref-for-index-term-contains-for-map-5">contain</a> <var>prompt type</var>
+   types</a> does not <a data-link-type="dfn|abstract-op" data-type="dfn" href="https://infra.spec.whatwg.org/#map-exists" id="ref-for-index-term-contains-for-map-6">contain</a> <var>prompt type</var>
    return <a href="#dfn-error" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-error-252">error</a> with <a href="#dfn-error-code" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-error-code-226">error code</a> <a href="#dfn-invalid-argument" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-invalid-argument-101">invalid argument</a>.
 
    </p></li><li><p>If <a href="#dfn-known-prompt-handlers" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-known-prompt-handlers-1">known prompt handlers</a> does not contain an entry
@@ -11317,7 +11322,7 @@ <h1 id="title" class="title">WebDriver</h1>
 
   </p><ol>
    <li><p>If the <a href="#dfn-user-prompt-handler" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-user-prompt-handler-6">user prompt handler</a>
-   <a data-link-type="dfn|abstract-op" data-type="dfn" href="https://infra.spec.whatwg.org/#map-exists" id="ref-for-index-term-contains-for-map-6">contains</a> <var>request prompt type</var>:
+   <a data-link-type="dfn|abstract-op" data-type="dfn" href="https://infra.spec.whatwg.org/#map-exists" id="ref-for-index-term-contains-for-map-7">contains</a> <var>request prompt type</var>:
 
     </p><ol>
 
@@ -11364,7 +11369,7 @@ <h1 id="title" class="title">WebDriver</h1>
  handler configuration</a> with <a href="#dfn-user-prompt-handler" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-user-prompt-handler-14">user prompt
  handler</a>["<code>fallbackDefault</code>"].
 
- </p></li><li><p>Let <var>serialized</var> be an empty <a data-type="dfn" href="https://infra.spec.whatwg.org/#ordered-map" id="ref-for-index-term-map-8">map</a>.
+ </p></li><li><p>Let <var>serialized</var> be an empty <a data-type="dfn" href="https://infra.spec.whatwg.org/#ordered-map" id="ref-for-index-term-map-9">map</a>.
 
  </p></li><li><p>For each <var>key</var> → <code>value</code> of <a href="#dfn-user-prompt-handler" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-user-prompt-handler-15">user prompt
  handler</a>:
@@ -11407,7 +11412,7 @@ <h1 id="title" class="title">WebDriver</h1>
    and <a data-link-type="dfn|abstract-op" href="#dfn-notify" class="internalDFN" id="ref-for-dfn-notify-5">notify</a> false.
 
  </p></li><li><p>If <var>handlers</var> contains "<code>fallbackDefault</code>"
- return <var>handlers</var>["<code>default</code>"].
+ return <var>handlers</var>["<code>fallbackDefault</code>"].
 
  </p></li><li><p>Return a <a href="#dfn-prompt-handler-configuration" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-prompt-handler-configuration-4">prompt handler
    configuration</a> with <a data-link-type="dfn|abstract-op" href="#dfn-handler" class="internalDFN" id="ref-for-dfn-handler-7">handler</a> "<code>dismiss</code>" and <a data-link-type="dfn|abstract-op" href="#dfn-notify" class="internalDFN" id="ref-for-dfn-notify-6">notify</a> true.
@@ -25537,7 +25542,7 @@ <h1 id="title" class="title">WebDriver</h1>
     </li><li>
       <a href="#ref-for-index-term-contains-for-map-3" title="§ 15.3 Input state">§ 15.3 Input state</a> <a href="#ref-for-index-term-contains-for-map-4" title="Reference 2">(2)</a> 
     </li><li>
-      <a href="#ref-for-index-term-contains-for-map-5" title="§ 16.1 User Prompt Handler">§ 16.1 User Prompt Handler</a> <a href="#ref-for-index-term-contains-for-map-6" title="Reference 2">(2)</a> 
+      <a href="#ref-for-index-term-contains-for-map-5" title="§ 16.1 User Prompt Handler">§ 16.1 User Prompt Handler</a> <a href="#ref-for-index-term-contains-for-map-6" title="Reference 2">(2)</a> <a href="#ref-for-index-term-contains-for-map-7" title="Reference 3">(3)</a> 
     </li>
   </ul>
     </div><div class="dfn-panel" hidden="" role="dialog" aria-modal="true" id="dfn-panel-for-index-term-continue-for-iteration" aria-label="Links in this document to definition: continue (for iteration)">
@@ -25629,7 +25634,7 @@ <h1 id="title" class="title">WebDriver</h1>
     </li><li>
       <a href="#ref-for-index-term-map-3" title="§ 12. Elements">§ 12. Elements</a> 
     </li><li>
-      <a href="#ref-for-index-term-map-4" title="§ 16.1 User Prompt Handler">§ 16.1 User Prompt Handler</a> <a href="#ref-for-index-term-map-5" title="Reference 2">(2)</a> <a href="#ref-for-index-term-map-6" title="Reference 3">(3)</a> <a href="#ref-for-index-term-map-7" title="Reference 4">(4)</a> <a href="#ref-for-index-term-map-8" title="Reference 5">(5)</a> 
+      <a href="#ref-for-index-term-map-4" title="§ 16.1 User Prompt Handler">§ 16.1 User Prompt Handler</a> <a href="#ref-for-index-term-map-5" title="Reference 2">(2)</a> <a href="#ref-for-index-term-map-6" title="Reference 3">(3)</a> <a href="#ref-for-index-term-map-7" title="Reference 4">(4)</a> <a href="#ref-for-index-term-map-8" title="Reference 5">(5)</a> <a href="#ref-for-index-term-map-9" title="Reference 6">(6)</a> 
     </li>
   </ul>
     </div><div class="dfn-panel" hidden="" role="dialog" aria-modal="true" id="dfn-panel-for-index-term-queue" aria-label="Links in this document to definition: queue">
