Allow ignoring position or dimensions in set window rect

Previously it was unclear if it was acceptable to return without error
from set window rect if the implementation is unable to set some of
the properties.

This updates the spec so that:

* It's unambiguously OK to run the command even if you don't support
some aspects of the functionality on the current platform /
configuration (you are expected to continue to return an error if you
don't support any aspect of the functionality).

* It's clear that both position and dimension properties are best
effort, and even if you are able to adjust them there's no guarantee
that you get the exact requested values.

* It's clear what to do if you get just an x coordinate but not y, or
just width but not height, or vice-versa. Previously this was undefined.

Author: jgraham

index.html

@@ -4044,25 +4044,23 @@ Set Window Rect
 <ol>
  <li><p>Let <var>widthvar> be the result of
   <a>getting a propertya> named "<code>widthcode>"
-  from <var>parametersvar>, else let it be <a><code>nullcode>a>.
+  from <var>parametersvar>a>.
 
  <li><p>Let <var>heightvar> be the result of
   <a>getting a propertya> named "<code>heightcode>"
-  from <var>parametersvar>, else let it be <a><code>nullcode>a>.
+  from <var>parametersvar>.
 
  <li><p>Let <var>xvar> be the result of <a>getting a propertya>
-  named "<code>xcode>" from <var>parametersvar>,
-  else let it be <a><code>nullcode>a>.
+  named "<code>xcode>" from <var>parametersvar>.
 
  <li><p>Let <var>yvar> be the result of <a>getting a propertya>
-  named "<code>ycode>" from <var>parametersvar>,
-  else let it be <a><code>nullcode>a>.
+  named "<code>ycode>" from <var>parametersvar>.
 
- <li><p>If <var>widthvar> or <var>heightvar> is neither <a><code>nullcode>a>
+ <li><p>If <var>widthvar> or <var>heightvar> is neither <a>undefineda>
   nor a <a>Numbera> from 0 to 2<sup>31sup> − 1,
   return <a>errora> with <a>error codea> <a>invalid argumenta>.
 
- <li><p>If <var>xvar> or <var>yvar> is neither <a><code>nullcode>a>
+ <li><p>If <var>xvar> or <var>yvar> is neither <a>undefineda>
   nor a <a>Numbera> from −(2<sup>31sup>) to 2<sup>31sup> − 1,
   return <a>errora> with <a>error codea> <a>invalid argumenta>.
 
@@ -4071,6 +4069,11 @@ Set Window Rect
   <var>sessionvar>'s <a>current top-level browsing contexta> for any reason,
   return <a>errora> with <a>error codea> <a>unsupported operationa>.
 
+  <p class="note">In case the <a>Set Window Recta> command is
+  partially supported (i.e. some combinations of arguments are
+  supported but not others), the implmentation is expected to continue
+  with the remaining steps.
+
  <li><p>If <var>sessionvar>'s <a>current top-level browsing
   contexta> is <a>no longer opena>, return <a>errora>
   with <a>error codea> <a>no such windowa>.
@@ -4082,21 +4085,25 @@ Set Window Rect
 
  <li><p><a>Restore the windowa>.
 
- <li><p>If <var>widthvar> and <var>heightvar> are not <a><code>nullcode>a>:
+ <li><p>Let <var>windowvar> be the operating system window containing
+     <var>sessionvar>'s <a>current top-level browsing contexta>
+
+ <li><p>If the implementation is able to set the dimensions
+ of <var>windowvar>:
 
   <ol>
-   <li><p>Set the width, in <a>CSS pixelsa>,
-    of the operating system window containing
-    <var>sessionvar>'s <a>current top-level browsing contexta>,
-    including any <a>browser chromea> and externally drawn window decorations
+   <li><p>If <var>widthvar> is not <a>undefineda>, set the width,
+    in <a>CSS pixelsa>, of <var>windowvar>, including
+    any <a>browser chromea> and externally drawn window decorations,
     to a value that is as close as possible to <var>widthvar>.
 
-  <li><p>Set the height, in <a>CSS pixelsa>,
-   of the operating system window containing
-   <var>sessionvar>'s <a>current top-level browsing contexta>,
-   including any <a>browser chromea> and externally drawn window decorations
+  <li><p>If <var>heightvar> is not <a>undefineda>, set the height,
+   in <a>CSS pixelsa>, of <var>windowvar>, including
+   any <a>browser chromea> and externally drawn window decorations,
    to a value that is as close as possible to <var>heightvar>.
 
+  ol>
+
    <aside class=note>
     <p>The specification does not guarantee
      that the resulting window size will exactly match that which was requested.
@@ -4116,35 +4123,37 @@ Set Window Rect
      of <a>outerHeighta> should be as close as possible
      to <var>heightvar>.
    aside>
-  ol>
 
- <li><p>If <var>xvar> and <var>yvar> are not <a><code>nullcode>a>:
+ <li><p>If the implementation is able to set the position of <var>windowvar>:
 
   <ol>
-   <li><p>Run the implementation-specific steps to set the position of
-    the operating system level window
-    containing <var>sessionvar>'s <a>current top-level browsing
-    contexta> to the position given by the <var>xvar>
-    and <var>yvar> coordinates.
-
-    <aside class=note>
-     <p>Note that this step is similar to calling the <a>moveTo(x,
-      y)a> method on the <a><code>WindowProxycode>a> object
-      associated with <var>sessionvar>'s <a>current top-level browsing
-      contexta>, but without the
-      <a href=https://developer.mozilla.org/en-US/docs/Web/API/Window/moveTo>security
-      restrictionsa> that you
-
-     <ol type=a>
-      <li>cannot move a window or tab
-       that was not created by <code>window.opencode>.
-
-      <li>cannot move a window or tab
-       when it is in a window with more than one tab.
-     ol>
-   aside>
+   <li><p>If <var>xvar> is not <a>undefineda>, run specific
+    steps set the x-coordinate of the left edge of <var>windowvar>
+    to a value that is as close as possible to <var>xvar>.
+
+   <li><p>If <var>yvar> is not <a>undefineda>, run specific
+    steps set the y-coordinate of the top edge of <var>windowvar> to
+    a value that is as close as possible to <var>yvar>.
   ol>
 
+  <aside class=note>
+    <p>The specification does not guarantee
+     that the resulting window position will match that which was requested.
+
+   <p>This step is similar to calling the <a>moveTo(x,
+    y)a> method on the <a><code>WindowProxycode>a> object
+    associated with <var>sessionvar>'s <a>current top-level browsing
+    contexta>, but without the
+    <a href=https://developer.mozilla.org/en-US/docs/Web/API/Window/moveTo>security
+    restrictionsa> that you
+
+   <ol type=a>
+    <li>cannot move a window or tab that was not created by <code>window.opencode>.
+
+    <li>cannot move a window or tab when it is in a window with more than one tab.
+   ol>
+  aside>
+
  <li><p>Return <a>successa> with data set to the <a>WindowRect
   objecta> for the <var>sessionvar>'s <a>current top-level browsing
   contexta>.