Use visual viewport instead of initial viewport in screenshot algorithm (#1951)

Sameem-baba · github-actions[bot] · Sameem-baba · commit 072346f2af44 · 2026-03-19T15:17:30.000Z
SHA: 1d4b691 Reason: push, by whimboo Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
diff --git a/index.html b/index.html
@@ -1,6 +1,6 @@
 <!DOCTYPE html><html lang="en-us" data-issue-url="https://github.com/w3c/webdriver/" data-issue-param-milestone="Level 1"><head>
 <meta charset="utf-8">
-<meta name="generator" content="ReSpec 35.6.1">
+<meta name="generator" content="ReSpec 35.8.0">
 <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
 <style>
 span.example-title{text-transform:none}
@@ -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="cc4c0d2b52cc99b0d6c6d60fad8b481f51bffa33">
+<meta name="revision" content="1d4b69147a6b0e87f6d2402e608a1501113d3bf2">
 <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
@@ -289,15 +289,15 @@
     ],
     "profile": "web-platform"
   },
-  "gitRevision": "cc4c0d2b52cc99b0d6c6d60fad8b481f51bffa33",
-  "publishISODate": "2026-02-06T00:00:00.000Z",
-  "generatedSubtitle": "W3C Editor's Draft 06 February 2026"
+  "gitRevision": "1d4b69147a6b0e87f6d2402e608a1501113d3bf2",
+  "publishISODate": "2026-03-19T00:00:00.000Z",
+  "generatedSubtitle": "W3C Editor's Draft 19 March 2026"
 }</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="2026-02-06">06 February 2026</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="2026-03-19">19 March 2026</time></p>
     <details open="">
       <summary>More details about this document</summary>
       <dl>
@@ -11692,12 +11692,12 @@ <h1 id="title" class="title">WebDriver</h1>
 
 <p>Screenshots are a mechanism for providing
  additional visual diagnostic information.
- They work by dumping a snapshot of the <a href="#dfn-viewport" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-viewport-4">initial viewport</a>'s
+ They work by dumping a snapshot of the <a href="#dfn-visual-viewport" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-visual-viewport-1">visual viewport</a>'s
  framebuffer as a lossless PNG image.
  It is returned to the <a href="#dfn-local-ends" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-local-ends-18">local end</a> as a Base64 encoded string.
 
 </p><p>WebDriver provides the <a href="#dfn-take-screenshot" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-take-screenshot-2">Take Screenshot</a> <a href="#dfn-commands" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-commands-60">command</a>
- to capture the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/document-sequences.html#top-level-browsing-context" id="ref-for-index-term-top-level-browsing-contexts-28">top-level browsing context</a>'s <a href="#dfn-viewport" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-viewport-5">initial viewport</a>,
+ to capture the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/document-sequences.html#top-level-browsing-context" id="ref-for-index-term-top-level-browsing-contexts-28">top-level browsing context</a>'s <a href="#dfn-visual-viewport" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-visual-viewport-2">visual viewport</a>,
  and a <a href="#dfn-commands" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-commands-61">command</a> <a href="#dfn-take-element-screenshot" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-take-element-screenshot-2">Take Element Screenshot</a>
  for doing the same with the visible region of an <a data-link-type="dfn" href="https://dom.spec.whatwg.org/#concept-element" id="ref-for-index-term-element-42">element</a>'s
  <a href="#dfn-bounding-rectangle" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-bounding-rectangle-4">bounding rectangle</a> after it has been <a href="#dfn-scrolls-into-view" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-scrolls-into-view-7">scrolled into view</a>.
@@ -11706,15 +11706,15 @@ <h1 id="title" class="title">WebDriver</h1>
  given a <a href="#dfn-bounding-rectangle" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-bounding-rectangle-5">rectangle</a>:
 
 </p><ol>
- <li><p>If either the <a href="#dfn-viewport" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-viewport-6">initial viewport</a>'s width or height
+ <li><p>If either the <a href="#dfn-visual-viewport" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-visual-viewport-3">visual viewport</a>'s width or height
   is 0 <a href="#dfn-css-pixels" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-css-pixels-11">CSS pixels</a>,
   return <a href="#dfn-error" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-error-272">error</a> with <a href="#dfn-error-code" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-error-code-245">error code</a> <a href="#dfn-unable-to-capture-screen" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-unable-to-capture-screen-1">unable to capture screen</a>.
 
- </p></li><li><p>Let <var>paint width</var> be the <a href="#dfn-viewport" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-viewport-7">initial viewport</a>'s width –
+ </p></li><li><p>Let <var>paint width</var> be the <a href="#dfn-visual-viewport" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-visual-viewport-4">visual viewport</a>'s width –
   <a href="#dfn-min" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-min-5">min</a>(<a href="#dfn-x-coordinate" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-x-coordinate-6">rectangle x coordinate</a>,
   <a href="#dfn-x-coordinate" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-x-coordinate-7">rectangle x coordinate</a> + <a href="#dfn-width-dimension" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-width-dimension-4">rectangle width dimension</a>).
 
- </p></li><li><p>Let <var>paint height</var> be the <a href="#dfn-viewport" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-viewport-8">initial viewport</a>'s height –
+ </p></li><li><p>Let <var>paint height</var> be the <a href="#dfn-visual-viewport" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-visual-viewport-5">visual viewport</a>'s height –
   <a href="#dfn-min" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-min-6">min</a>(<a href="#dfn-y-coordinate" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-y-coordinate-6">rectangle y coordinate</a>,
   <a href="#dfn-y-coordinate" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-y-coordinate-7">rectangle y coordinate</a> + <a href="#dfn-height-dimension" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-height-dimension-4">rectangle height dimension</a>).
 
@@ -12230,7 +12230,7 @@ <h1 id="title" class="title">WebDriver</h1>
 
 
 <p>Although WebDriver does not define a primitive
- to ascertain the visibility of an <a data-link-type="dfn" href="https://dom.spec.whatwg.org/#concept-element" id="ref-for-index-term-element-45">element</a> in the <a href="#dfn-viewport" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-viewport-9">viewport</a>,
+ to ascertain the visibility of an <a data-link-type="dfn" href="https://dom.spec.whatwg.org/#concept-element" id="ref-for-index-term-element-45">element</a> in the <a href="#dfn-viewport" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-viewport-4">viewport</a>,
  we acknowledge that it is an important feature for many users.
  Here we include a recommended approach
  which will give a simplified approximation of an <a data-link-type="dfn" href="https://dom.spec.whatwg.org/#concept-element" id="ref-for-index-term-element-46">element</a>'s visibility,
@@ -12734,6 +12734,7 @@ <h1 id="title" class="title">WebDriver</h1>
     </li><li><dfn id="dfn-scrollintoviewoptions" tabindex="0" aria-haspopup="dialog" data-dfn-type="dfn"><a href="https://drafts.csswg.org/cssom-view/#dictdef-scrollintoviewoptions"><code>ScrollIntoViewOptions</code></a></dfn>
     </li><li><dfn id="dfn-logical-scroll-position-block" tabindex="0" aria-haspopup="dialog" data-dfn-type="dfn"><a href="https://drafts.csswg.org/cssom-view/#dom-scrollintoviewoptions-block">Logical scroll position "<code>block</code>"</a></dfn>
     </li><li><dfn id="dfn-logical-scroll-position-inline" tabindex="0" aria-haspopup="dialog" data-dfn-type="dfn"><a href="https://drafts.csswg.org/cssom-view/#dom-scrollintoviewoptions-inline">Logical scroll position "<code>inline</code>"</a></dfn>
+    </li><li><dfn id="dfn-visual-viewport" tabindex="0" aria-haspopup="dialog" data-dfn-type="dfn"><a href="https://drafts.csswg.org/cssom-view/#visual-viewport">visual viewport</a></dfn>
   </li></ul>
 
  </dd><dd>The following terms are defined in  [<cite><a class="bibref" data-link-type="biblio" href="#bib-mediaqueries-4" title="Media Queries Level 4">mediaqueries-4</a></cite>]:
@@ -13981,6 +13982,8 @@ <h1 id="title" class="title">WebDriver</h1>
       <a class="index-term" href="#dfn-visibility-hidden">Visibility state hidden</a> 
     <span class="print-only">§E.</span></li><li>
       <a class="index-term" href="#dfn-visibility-visible">Visibility state visible</a> 
+    <span class="print-only">§E.</span></li><li>
+      <a class="index-term" href="#dfn-visual-viewport">visual viewport</a> 
     <span class="print-only">§E.</span></li><li>
       <a class="index-term" href="#dfn-wai-aria-role">WAI-ARIA role</a> 
     <span class="print-only">§E.</span></li><li>
@@ -14281,7 +14284,7 @@ <h1 id="title" class="title">WebDriver</h1>
     <dl class="bibliography"><dt id="bib-accname-1.1">[accname-1.1]</dt><dd>
       <a href="https://www.w3.org/TR/accname-1.1/"><cite>Accessible Name and Description Computation 1.1</cite></a>. Joanmarie Diggs; Bryan Garaventa; Michael Cooper.  W3C. 18 December 2018. W3C Recommendation. URL: <a href="https://www.w3.org/TR/accname-1.1/">https://www.w3.org/TR/accname-1.1/</a>
     </dd><dt id="bib-csp3">[CSP3]</dt><dd>
-      <a href="https://www.w3.org/TR/CSP3/"><cite>Content Security Policy Level 3</cite></a>. Mike West; Antonio Sartori.  W3C. 6 February 2026. W3C Working Draft. URL: <a href="https://www.w3.org/TR/CSP3/">https://www.w3.org/TR/CSP3/</a>
+      <a href="https://www.w3.org/TR/CSP3/"><cite>Content Security Policy Level 3</cite></a>. Mike West; Antonio Sartori.  W3C. 11 March 2026. W3C Working Draft. URL: <a href="https://www.w3.org/TR/CSP3/">https://www.w3.org/TR/CSP3/</a>
     </dd><dt id="bib-css-cascade-4">[CSS-CASCADE-4]</dt><dd>
       <a href="https://www.w3.org/TR/css-cascade-4/"><cite>CSS Cascading and Inheritance Level 4</cite></a>. Elika Etemad; Tab Atkins Jr. W3C. 13 January 2022. W3C Candidate Recommendation. URL: <a href="https://www.w3.org/TR/css-cascade-4/">https://www.w3.org/TR/css-cascade-4/</a>
     </dd><dt id="bib-css-device-adapt">[CSS-DEVICE-ADAPT]</dt><dd>
@@ -14321,11 +14324,11 @@ <h1 id="title" class="title">WebDriver</h1>
     </dd><dt id="bib-infra">[INFRA]</dt><dd>
       <a href="https://infra.spec.whatwg.org/"><cite>Infra Standard</cite></a>. Anne van Kesteren; Domenic Denicola.  WHATWG. Living Standard. URL: <a href="https://infra.spec.whatwg.org/">https://infra.spec.whatwg.org/</a>
     </dd><dt id="bib-mediaqueries-4">[mediaqueries-4]</dt><dd>
-      <a href="https://www.w3.org/TR/mediaqueries-4/"><cite>Media Queries Level 4</cite></a>. Florian Rivoal; Tab Atkins Jr. W3C. 25 December 2021. CRD. URL: <a href="https://www.w3.org/TR/mediaqueries-4/">https://www.w3.org/TR/mediaqueries-4/</a>
+      <a href="https://www.w3.org/TR/mediaqueries-4/"><cite>Media Queries Level 4</cite></a>. Tab Atkins Jr.; Florian Rivoal.  W3C. 19 February 2026. CRD. URL: <a href="https://www.w3.org/TR/mediaqueries-4/">https://www.w3.org/TR/mediaqueries-4/</a>
     </dd><dt id="bib-page-visibility">[PAGE-VISIBILITY]</dt><dd>
       <a href="https://www.w3.org/TR/page-visibility/"><cite>Page Visibility (Second Edition)</cite></a>. Jatinder Mann; Arvind Jain.  W3C. 29 October 2013. W3C Recommendation. URL: <a href="https://www.w3.org/TR/page-visibility/">https://www.w3.org/TR/page-visibility/</a>
     </dd><dt id="bib-pointer-events">[POINTER-EVENTS]</dt><dd>
-      <a href="https://www.w3.org/TR/pointerevents/"><cite>Pointer Events</cite></a>. Jacob Rossi; Matt Brubeck.  W3C. 4 April 2019. W3C Recommendation. URL: <a href="https://www.w3.org/TR/pointerevents/">https://www.w3.org/TR/pointerevents/</a>
+      <a href="https://www.w3.org/TR/pointerevents4/"><cite>Pointer Events</cite></a>. Patrick Lauke; Robert Flack.  W3C. 25 February 2026. W3C Working Draft. URL: <a href="https://www.w3.org/TR/pointerevents4/">https://www.w3.org/TR/pointerevents4/</a>
     </dd><dt id="bib-promises-guide">[PROMISES-GUIDE]</dt><dd>
       <a href="https://www.w3.org/2001/tag/doc/promises-guide"><cite>Writing Promise-Using Specifications</cite></a>. Domenic Denicola.  W3C. 9 November 2018. TAG Finding. URL: <a href="https://www.w3.org/2001/tag/doc/promises-guide">https://www.w3.org/2001/tag/doc/promises-guide</a>
     </dd><dt id="bib-rfc1928">[RFC1928]</dt><dd>
@@ -14359,7 +14362,7 @@ <h1 id="title" class="title">WebDriver</h1>
     </dd><dt id="bib-uax44">[UAX44]</dt><dd>
       <a href="https://www.unicode.org/reports/tr44/tr44-36.html"><cite>Unicode Character Database</cite></a>. Ken Whistler.  Unicode Consortium. 27 August 2025. Unicode Standard Annex #44. URL: <a href="https://www.unicode.org/reports/tr44/tr44-36.html">https://www.unicode.org/reports/tr44/tr44-36.html</a>
     </dd><dt id="bib-ui-events">[UI-EVENTS]</dt><dd>
-      <a href="https://www.w3.org/TR/uievents/"><cite>UI Events</cite></a>. Gary Kacmarcik; Travis Leithead.  W3C. 7 September 2024. W3C Working Draft. URL: <a href="https://www.w3.org/TR/uievents/">https://www.w3.org/TR/uievents/</a>
+      <a href="https://www.w3.org/TR/uievents/"><cite>UI Events</cite></a>. Xiaoqian Wu.  W3C. 21 February 2026. W3C Working Draft. URL: <a href="https://www.w3.org/TR/uievents/">https://www.w3.org/TR/uievents/</a>
     </dd><dt id="bib-uievents-key">[UIEVENTS-KEY]</dt><dd>
       <a href="https://www.w3.org/TR/uievents-key/"><cite>UI Events KeyboardEvent key Values</cite></a>. Travis Leithead; Gary Kacmarcik.  W3C. 22 April 2025. W3C Recommendation. URL: <a href="https://www.w3.org/TR/uievents-key/">https://www.w3.org/TR/uievents-key/</a>
     </dd><dt id="bib-unicode">[Unicode]</dt><dd>
@@ -14371,7 +14374,7 @@ <h1 id="title" class="title">WebDriver</h1>
     </dd><dt id="bib-wai-aria-1.2">[wai-aria-1.2]</dt><dd>
       <a href="https://www.w3.org/TR/wai-aria-1.2/"><cite>Accessible Rich Internet Applications (WAI-ARIA) 1.2</cite></a>. Joanmarie Diggs; James Nurthen; Michael Cooper; Carolyn MacLeod.  W3C. 6 June 2023. W3C Recommendation. URL: <a href="https://www.w3.org/TR/wai-aria-1.2/">https://www.w3.org/TR/wai-aria-1.2/</a>
     </dd><dt id="bib-webdriver-bidi">[WebDriver-BiDi]</dt><dd>
-      <a href="https://www.w3.org/TR/webdriver-bidi/"><cite>WebDriver BiDi</cite></a>. James Graham; Alex Rudenko; Maksim Sadym.  W3C. 28 January 2026. W3C Working Draft. URL: <a href="https://www.w3.org/TR/webdriver-bidi/">https://www.w3.org/TR/webdriver-bidi/</a>
+      <a href="https://www.w3.org/TR/webdriver-bidi/"><cite>WebDriver BiDi</cite></a>. James Graham; Alex Rudenko; Maksim Sadym.  W3C. 17 March 2026. W3C Working Draft. URL: <a href="https://www.w3.org/TR/webdriver-bidi/">https://www.w3.org/TR/webdriver-bidi/</a>
     </dd><dt id="bib-webidl">[WEBIDL]</dt><dd>
       <a href="https://webidl.spec.whatwg.org/"><cite>Web IDL Standard</cite></a>. Edgar Chen; Timothy Gu.  WHATWG. Living Standard. URL: <a href="https://webidl.spec.whatwg.org/">https://webidl.spec.whatwg.org/</a>
     </dd><dt id="bib-xpath">[XPATH]</dt><dd>
@@ -24012,9 +24015,7 @@ <h1 id="title" class="title">WebDriver</h1>
     </li><li>
       <a href="#ref-for-dfn-viewport-3" title="§ 12.5.1 Element Click">§ 12.5.1 Element Click</a> 
     </li><li>
-      <a href="#ref-for-dfn-viewport-4" title="§ 17. Screen capture">§ 17. Screen capture</a> <a href="#ref-for-dfn-viewport-5" title="Reference 2">(2)</a> <a href="#ref-for-dfn-viewport-6" title="Reference 3">(3)</a> <a href="#ref-for-dfn-viewport-7" title="Reference 4">(4)</a> <a href="#ref-for-dfn-viewport-8" title="Reference 5">(5)</a> 
-    </li><li>
-      <a href="#ref-for-dfn-viewport-9" title="§ C. Element displayedness">§ C. Element displayedness</a> 
+      <a href="#ref-for-dfn-viewport-4" title="§ C. Element displayedness">§ C. Element displayedness</a> 
     </li>
   </ul>
     </div><div class="dfn-panel" hidden="" role="dialog" aria-modal="true" id="dfn-panel-for-dfn-display" aria-label="Links in this document to definition: display">
@@ -24306,6 +24307,18 @@ <h1 id="title" class="title">WebDriver</h1>
     <li>
       <a href="#ref-for-dfn-logical-scroll-position-inline-1" title="§ 12. Elements">§ 12. Elements</a> 
     </li>
+  </ul>
+    </div><div class="dfn-panel" hidden="" role="dialog" aria-modal="true" id="dfn-panel-for-dfn-visual-viewport" aria-label="Links in this document to definition: visual viewport">
+      <span class="caret"></span>
+      <div>
+        <a class="self-link" href="#dfn-visual-viewport" aria-label="Permalink for definition: visual viewport. Activate to close this dialog.">Permalink</a>
+         
+      </div>
+      <p><b>Referenced in:</b></p>
+      <ul>
+    <li>
+      <a href="#ref-for-dfn-visual-viewport-1" title="§ 17. Screen capture">§ 17. Screen capture</a> <a href="#ref-for-dfn-visual-viewport-2" title="Reference 2">(2)</a> <a href="#ref-for-dfn-visual-viewport-3" title="Reference 3">(3)</a> <a href="#ref-for-dfn-visual-viewport-4" title="Reference 4">(4)</a> <a href="#ref-for-dfn-visual-viewport-5" title="Reference 5">(5)</a> 
+    </li>
   </ul>
     </div><div class="dfn-panel" hidden="" role="dialog" aria-modal="true" id="dfn-panel-for-dfn-media-type" aria-label="Links in this document to definition: media type">
       <span class="caret"></span>
